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Discover the joy of programming with the biggest 
and best introductory guide for the Raspberry Pi 
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USE THE PI FOR GOOD 


BOINC turns an idling Pi 
into a force for science 
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Take pictures 
and make videos 
in easy steps 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a Club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 
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profoundly life-changing things you 
can do. So says Lucy Hattersley in her 
beginner’s guide to coding, starting on page 14. 
She’s right too; I distinctly remember the 
feeling of euphoria I got from finishing my first 
coding project from scratch. It must be like being SUBSCRIBE & 
a young Harry Potter learning of his life beyond 
the cupboard under the stairs. Realising that you SEE PAGE 28 FOR DETAILS 
have the power to conjure up something entirely 
new and unique from your fingertips is about as 


life-changing as it comes. 
While we lack the witches and broomsticks THIS MONTH: 


of the wizarding world, we’re increasingly 
14 LEARN TO CODE 


surrounded by computers that do our bidding 
Make 2017 a journey of discovery! 
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and much of our thinking for us. It’s becoming 
urgently important that we understand their 


common tongue. While there’s a lifetime of A? REMOTELY ACCESS YOUR PI 


learning out there, the magazine you’re holding , | | 
; Learn how to use SSH in another Raspberry Pi 101 guide 
can — believe it or not - equip you with the 


skills you need to write just about any game or 70 USE DEBIAN + PIXEL ON YOUR PC 
application you can imagine. Yes, even that one! Test-drive your Raspberry Pi experience on a spare PC today! 
Russell Barnes 96 MAKE 2017 A YEAR FOR MAKING 
Managing Editor New Year's resolutions don't come any better than this 
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Learn how to remotely access your Raspberry P| 
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An introduction to the Raspberry Pi Camera Module 
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Program push buttons to make different sounds 
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Learn how to use arrays and strings in C 
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Get yourselves to the derby with Pi Bakery 
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Use BOINC to donate your Pi's resources to science 
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Use Google's DeepDream with Raspberry Pi 
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Sonic Pi returns this issue with sample stretching 
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See If anyone's been going into your room 
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Put a hedgehog on a trampoline in Scratch! 


The loT platform now supports Pi 
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EBEN 
HONOURED 


Eben Upton receives his 


CBE after being placed 


on the honours list in June 
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Learn how to use the x86 release of Raspbian The teen programme from 
on your PC, included on our cover disc! Raspberry Pi has launched! 
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FEATURE 


New York University is using hundreds of Raspberry Pis in the heart of the Big Apple 


New York is 
one of the busiest 
cities on Earth, and 
noise pollution is 
a big problem for 
its inhabitants 


ounds of New York City 
is anovel project by New 
York University (NYU) to 


monitor noise pollution in the city. 


“Noise pollution is one of the 
topmost quality of life issues for 
urban residents in the United 
States,” says NYU. “It has been 
estimated that nine out of ten 


The data recorded by the 
Raspberry Pi are being used to 
create a Mission Control Centre. 
Information from the network 
flows through the infrastructure 


that analyses the retrieved data. 
Machine learning techniques are 
being used to identify sources 
of noise pollution, such as police 
sirens or street music. 
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adults in New York City (NYC) are 


exposed to excessive noise levels.” 


To analyse the problem, NYU 
has set up Raspberry Pi devices 
with microphones to monitor 
audio levels around NYC. 

We caught up with Charlie 
Mydlarz, a senior research 
scientist working on the project. 
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“We are working with 
NYC agencies, including the 
Department of Environmental 
Protection, and we will provide 
them with an aggregated noise 
data stream so they can enforce 
the noise code more efficiently,” 
explains Charlie. “We also work 
with the Department of Health 
and Mental Hygiene in a bid to 
uncover relationships between 
health and noise in the city.” 


Sensor nodes 

“The sensor node is built around 
the Raspberry Pi 2B running a 
headless Jessie,” Charlie reveals. 
Attached to the Raspberry Pi is 

a digital microphone. “All data 
is transmitted via WiFi,” adds 
Charlie. It’s currently running 
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The Acoustic Sensing Devices contain a Raspberry Pi 


Noise pollution 1s one of the 
topmost quality of life issues for 
urban residents 1n the United States 


on the NYU network across 
its campus. 

“The sensors themselves don’t 
have aname,” he tells us, “but I 
usually call them Acoustic Sensing 
Devices or ASDs. ‘Listening box’ 
sounds way too ominous!” 

The team has worked hard to 
ensure that the project doesn’t 
encroach on privacy. “The audio 
data is collected in ten-second 
snippets, randomly separated 
in time to ensure privacy is 
maintained,” says Charlie. These 
audio snippets are compressed 
using the lossless FLAC encoder, 


New York University plans to deploy 
over 100 of the devices in its sensor 
network next year 
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and then encrypted using AES and 
RSA encryption. 

“We have done a lot of work 
to maintain privacy on the 
project, and have had an external 
consultant confirm that street- 
level, intelligible speech at 
conversational levels cannot be 
picked up,” insists Charlie. “A 
person would have to shout at 
the sensor for the speech to be 
intelligible, and that wouldn’t 
constitute a private conversation.” 

The team also deploy signs below 
each node to inform people what 
they are doing. 

“As of today, we have 20 nodes 
up and running,” Charlie tells us. 
By the end of 2016 they should 
have 50 deployed, and by spring 
2017 there will be 100. 

“These poor little Pis have 
just survived the hot and humid 
NYC summer and are about to 
experience the freezing winter,” 
says Charlie. “They’ve been 
fantastic so far and have spent 
weeks running in freezers in the 
lab, so ’m confident that they can 
take the winter too.” 
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IN LIBRARIES AND 
COMMUNITY CENTRES 
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PI JOINS 


The world’s most popular IoT cloud platform adds Pi support 


Build your own Particle-connected, Pi-powered security camera 


article, a cloud platform 

for Internet of Things 

(particle.io), has added 
official support for the Raspberry 
Pi. With the popularity of IoT 
projects on the Pi, the world’s 
most popular low-cost computer 
seems a natural fit for the world’s 
most popular IoT platform. 

“Particle is a scalable, reliable, 

and secure Internet of Things 
device platform that enables 
businesses to quickly and easily 
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build, connect, and manage their 
connected solutions,” comments 
Jonathan Gladbach, Particle’s Head 
of Growth. 

Following a beta programme 
limited to 1,000 users at the end of 
November, the service will be made 
available to all Raspberry Pi owners. 

You can sign up for a free 
account on the website 
(magpi.cc/2fuAOM2) and 
download the software to your Pi 
running Raspbian. Using either the 


>< Particle 


Particle Build web IDE or Particle 
Dev desktop application, you can 
then select your remote device 
and program it, with access to 
numerous community libraries. 

“Particle’s tools are now used 
by 70,000 engineers in more than 
170 countries,” says Jonathan. 
“[They] are being used by many 
Fortune 500 companies to 
develop and manage fleets of new 
IoT products.” 

A key feature is the ability 
to run Arduino Wiring code on 
the Raspberry Pi: “No more 
complicated tooling, setup, or 
Scripting to perform simple tasks 
like trigger a pin, blink an LED, 
or read a sensor value,” explains 
Jonathan. “With Particle’s 
Raspberry Pi Agent, you can now 
program in C and C++, making 
these tasks easy.” 

Webhooks are tightly integrated 
into Particle’s event system, 
and projects may be integrated 
with IFTTT, Google Cloud, or 
Microsoft Azure. 

Use cases for Particle include 
home automation, remote 
monitoring, resource management, 
triggers and buttons, and asset 
tracking. The Particle website 
includes Raspberry Pi tutorials 
(magpi.cc/2g7kxQB) to get you 
up and running with suggested 
projects, including a security 
camera (magpi.cc/2g7uCwH). 
Check out Adafruit’s demo video, 
too (magpi.cc/2g7ndxl). 


The Particle Dev desktop application allows you to work 
with local copies of your firmware files 
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NEW YEAR. 
NEW POSSIBILITIES. 


Accessories for Raspberry Pi 


WD SMART CABLE MODULE 


Upgradeable hardware with built-in CM programming mode 
2xUSBports 10/100 Ethernetjack 802.11b/g/n Wi-Fi 


The Media Stick for Raspberry Pi Compute Module” offers an 
easy way to quickly turn a TV or monitor into a powerful 
media hub or a custom Gigital display. 


"Raspberry Fi Compute Module not included. 
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WDLABS 


This all-in-one lot edge node server offers onboard computing capabilities 
for autonomous projects like video recording, data logging, and more. 


wdlabs.wd.com/products 


11 MILLION — > 


Raspberry Pi sales pass another major milestone 


n 25 November, it was 

confirmed that total sales 

of the Raspberry Pi have 
now topped 11 million. 

Considering that Pi sales only 
reached the ten million milestone 
at the start of September, that 
means it’s taken less than three 
months to add a further million. 

Even more impressive, it turns 
out that this figure is only for 
the flagship Pi models: the B, B+, 
Pi 2, and Pi 3. “Those are only 
the $35 product,” Raspberry Pi 
Trading CEO Eben Upton tells 
us, “so there’s no A, no A+, no 
Compute Module, no Pi Zero.” 

He estimates that sales of the 
other Pi models total at least 
another million. 

The next milestone will be to 
bypass sales of the Commodore 
64, estimated at 13 million, for 
the Raspberry Pi to become the 
third best-selling computer 
of all time, behind the PC and 
Mac. “Neither of those are really 
catchable,” reckons Eben. Above Over 11 million Raspberry Pis have been made at the Sony factory in South Wales 


. 


Raspberry Pi founder is honoured at Buckingham Palace 

CBE oe aaa “all aspberry Pi co-founder earlier. In addition, “He asked 

reflects the work Eben Upton has received us how many we’d sold. I said 

4 le ae ad the CBE (Commander of 11 million. He said ‘Wow!’ It looks 
the Order of the British Empire) like someone noticed.” 
medal from HRH Prince Charles Eben told us he might hang his 
during an investiture ceremony medal on the Christmas tree. “It 
on 25 November. certainly would be the prettiest 


Accompanied by his wife Liz and Christmas ornament I’ve got.” 
his parents, Eben described his visit While it’s a great personal honour, 
to Buckingham Palaceasa“funday he says it also reflects the work of 
out.” He reveals that he and Prince — the Foundation and the many tens 
Charles chatted about a previous of people who have worked for it, 
event they had both attended at along with hundreds of volunteers 
Highgrove House a couple of weeks — out in the community. 
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NEW OFFICIAL 


Updated Volume 2 includes Pi Zero content 


e’re proud to announce 
the release of The Official 
Raspberry Pi Projects Book 
Volume 2, complete with shiny 
foil cover. Inside are 200 pages 
absolutely stuffed with Pi projects, 
cuides, and reviews to help you on 


The latest Pi rue Official _ 
Projects Book RASPBERRY PI 
isoutjust JRRONm@sbess010)\4 
in time for pasate 
Christmas! 


4 


G7. @~r 
(Oy 
@® : 


es THe ML PD Tea UL ML 


your Raspberry Pi journey. Unlike 
last year’s original Projects Book, it 
includes a ton of Raspberry Pi Zero 
content to get your teeth into, as well 
as an updated Getting Started guide. 
We know a lot of you love the first 
Projects Book and we really hope you 
enjoy this new edition of it. You 
can grab the Projects Book Volume 2 
right now from our online store 
(magpi.cc/MagPiStore) for £12.99, 
and is available from our app on 
Android and iOS for a discounted 
£5.99. It has alreaday made a great 
stocking filler for Pi enthusiasts, but 
it's also a great way to start the New 
Year! It’s also available as a free PDF, 
from magpi.cc/Back-issues. 


Young digital makers are invited to join the 
Pioneers programme 


The stories we shared that 
flew around the world 


magpi.cc/2fv8SMZ 


The MagPi has been 
translated into four new 
languages: French, Spanish, 
Hebrew, and Italian. Each 
new magazine is a bite- 
sized edition, containing 20 
pages of the best projects 
and features. 
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magpi.cc/2fvdQJF 


Build your own equivalent to Nintendo's NES Classic, 
using an old game cartridge and a Pi Zero. Snazzy Labs’ 
video showing you how to do it has already racked up 
well over 200,000 views. 


magpi.cc/ 2fv8j5K 


Twitter magnified interest in this DIY digital microscope. 
The Post Apocalyptic Inventor stuck a Pi custom camera 
to the eyepiece of a standard scope for a low-cost 
solution that works amazingly well. 
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The 
new PiDrive 
models 
feature a 
micro SD card 


pre-loaded 


SERVER fan 


Sci-fi star beams up a Stellar Pi project 


et phasers to stun: using a Raspberry Pi 3 running 
Star Trek’s very own Raspbian, along with a hard 
Wil Wheaton has been drive, to ‘make it so’. 
building a Raspberry Pi home Asked by a Twitter follower 
media server. The American whether it could boost the 
actor, best known for playing efficiency of the warp core, Wil 
Wesley Crusher in Star Trek: responded, “If you add the right 
The Next Generation, was ‘hailing repository to apt.sources, it 
all frequencies’ on Twitter, can.” He also revealed that he’s 
@wilw, to announce the newsto finding it hard to resist getting 
fans: “I’m having so much fun a Picade retro gaming system: WD PID RIVE 
with my Raspberry Pi weekend “It’s getting increasingly 
project.” Following an online difficult.” Well, as most retro 
tutorial by developer Mel Grubb games fans already know, 
(magpi.cc/2fIs36c), Wil is ‘resistance is futile’. 
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Featuring NOOBS preloaded on SD 


DLabs has launched the third generation of 

its PiDrive products, offering an affordable 

hard drive storage solution for the Raspberry 
Pi. Known as the ‘Foundation Edition’, the new range 
includes two hard drive options — 250GB and 375GB -— 
along with a 64GB USB flash drive. 

While similar in format to previous PiDrive models, 
this edition features a micro SD card preloaded with 
the Raspberry Pi Foundation’s NOOBS installer, 
enabling users to easily install Raspbian with PIXEL, 
or an alternative operating system, without the need 
to flash a memory card manually. 


WDLabs has launched 
the third generation of 
its PiDrive products 


“This third generation WD PiDrive solution uses a 
USB HDD or USB flash drive to run the OS and host 
multiple Raspberry Pi projects, instead of having to 
do this on a collection of micro SD cards,” says Dave 
Chew, chief engineer at WDLabs. 

Available directly from wd.com, the PiDrive 


Wil Wheaton is hoping his Pi-powered home server will live long and prosper 
Foundation range is priced from $18.99 to $37.49. 
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SECURITY UPDATE 


Latest version of Raspbian OS beefs up security 


he Raspberry Pi 

Foundation released 

a new version of the 
Raspbian operating system on 
25 November 20106. 

The 1.1 release of Raspbian with 
PIXEL includes a number of fixes 
and adjustments. The new version 
of Raspbian also introduces a 
range of security measures. 

“We usually find a few small 
bugs and other issues as soon as 
the wider community start using 
it, and so we gather up the fixes 


and produce a1.1 release a few raaaapl 
weeks later,” writes Simon Long 
on The Raspberry Pi Foundation's PETE S| 
blog (magpi.cc/2gF9mhY). 
You can download the renee ds 
new image file from the * sess tena i mem it eared aoecs exc dooneee somporictes 
Foundation’s Downloads page at ag eae eee ee 
magpi.cc/1MYYTMo. Or update 
VOUMeXISHMNe Jessia@s Usile 
these commands in a terminal: 


RASPBIAN JESSIE WITH PIXEL 


sudo apt-get update ns | 
sudo apt-get dist-upgrade 
sudo apt-get install -y pprompt 


See) ee ee de he 


RASPBIAN JESSIE LITE 
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TAKING THE RASPBERRY PI TO THE NEXT LEVEL 


PROTECT YOUR FAMILY, FINANCES & FILES AT HOME & ON THE GO 


PROTECT FROM PHISHING 
Invitations to reveal your 
private information 


0; 


SHIELD FROM EXPLOITS 
Attackers working from 
outside your system 


CIPS’ 


ANYTIME, 
ANYPLACE 


10) 


DEVELOPED BY THE INDUSTRY EXPERTS 


tdappcom 


Our products are built on the best of British small computer, using 
our decades of expert security experience. We provide 24 hour 
security management via the cloud connected Idappcom 
Security Operations Centre. 


Taking the Raspberry Pi to the Next Level of Cyber Protection 
Visit: www.ipssecurityrules.com —_ Call: +44 (0) 203 355 6804 


Attacks that have been 
installed inside your system 


BLOCK MALWARE 


Discover the joy and art of computer programming with your Raspberry Pi 


earning to code is one of the most profoundly 
life-changing things you can do. This has 
always been true, but learning to code is 
increasingly important in the modern world. 
\ The reason the Raspberry Pi was created was to 
-_ challenge a drop in computer science applications 
\ at Cambridge University. Modern computers, and 

, especially games consoles, were fun and powerful, 
Mw but not easily programmable. 
a The maker community fell in love with the 
Raspberry Pi, thanks to its cheap and hackable 
nature. Building and tinkering are the primary 
reasons we love Raspberry Pi. Great projects use a 
combination of hardware and software together. 
So, whether you’re a hacker learning to make better 
projects, or a would-be coder looking for a better 
career, this feature is set to help you on your way. 
The good news is that you don’t need to be a genius 
to know coding, just as you don’t have to be a genius 
to read and write. It’s actually pretty simple once you 
learn a few simple concepts like variables, branching, 
and loops. 
Perhaps you’re brand-new to coding. Maybe you 
did a little BASIC in school, or used old languages like 
Pascal and Fortran. Or maybe you’ re already knee- 
deep in projects and just want to learn the language 
that controls them. 
Wherever you’re coming from, we’re here to 
walk you through the basic concepts of computer 
programming. We’ll demystify the whole process of 
code, so you can get a better understanding of what’s 
going on inside your Raspberry Pi. 
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Code Matters 


“| think everybody in this country should learn to program a 
computer,” said Apple's co-founder Steve Jobs, “because it 
teaches you how to think." 

Code is a critical layer in our lives that sits between us 
and the increasingly digital world that surrounds us. With 
just a small amount of understanding how code works, 
you'll be able to perform computer tasks faster and get a 
better understanding of the world around you. Increasingly, 
humans and machines are working together. 

Learning to use code and hardware is incredibly 
empowering. Computers are really about humanity; it’s 
about helping people by using technology. Whether it’s the 
home-made ophthalmoscope saving eyesight in India, or 
the Computer Aid Connect taking the internet to rural Africa, 
code on the Raspberry Pi is making a real difference. 

Coding also makes you more creative. It enables you to 
automate a whole bunch of boring and repetitive tasks in 
your life, freeing you up to concentrate on the fun stuff. 

It also teaches you how to solve problems in your life. 
Learning to how to put things in order, and how to break 
down a big, seemingly impossible task into several small 
but achievable tasks is profoundly life-changing. 

And if you're looking for a career boost, there's plenty of 
worse things to learn. “Our policy is literally to hire as many 
engineers as we can find,” says Mark Zuckerberg, CEO 
of Facebook. “The whole limit in the system is that there 
just aren't enough people who are trained to have these 
skills today.” 
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Python 2 and 
Python 3 are both 
commonly used. 
Python 3 is the 
future, So we're 
going with it. Lots 

of courses still teach 


Python 2, and it's 
not a bad idea to 
take a closer look 
at the differences 
between the two: 
magpi.cc/2gP6zX3 


Python is an ‘interpreted language’ 
You write the code and then run the 
program. Under the hood, it’s being 
translated and runs on the fly. Some 
languages, such as C and Java, are 
compiled. You write the program, then 
compile it to get a build file (written in 
machine code), then you run the build. 
It's a faff you can do without for now. 


Discover the building blocks of software 
e and learn what goes on inside a program 


efore you go any further, let’s look at what a 
program actually is. The dictionary definition 
is a “set of instructions that makes a 
computer do a particular thing.” 

A computer program is a lot like a recipe. It has 
a list of ingredients, called ‘variables’, and a list of 
instructions, known as ‘statements’ or ‘functions’. 
You follow the instructions from the recipe one line at 
a time and end up with a tasty cake - and that’s no lie. 

The real miracle of computers, however, is that 
they can do the same thing repeatedly. So you can 
get a machine to bake a thousand cakes without ever 
getting tired. A program may contain loops that make 
it do the same thing over and over again. 

Programs also make decisions, and different paths 
through a program can be taken. Your recipe could 
make a scrummy chocolate cake or a delightful 
batch of doughnuts, depending on the variables (the 
ingredients) it has. 


— 
© 


Oo 


bn) 
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One thing that may surprise you when you begin 
programming is just how little you need to know to 
get started. With just a few variables, a smattering 
of flow, and some functions, you can get a computer 
doing all the hard work for you. 


Inside your Pi 

At the heart of your Raspberry Pi are billions of voltage 
switches known as binary digits (or ‘bits’ for short). 
There are 8,589,934,592 of them in its 1GB of RAM, to 
be exact. All these switches can be set to high or low, 
which is typically represented as 0 (for low or off) and 
1 (for high or on). Everything you see on the screen, 
hear from the speakers, and type on the keyboard is 
billions of switches being turned on and off. 

Obviously, it’s not that easy for humans to talk 
directly to computers. It’s possible to use machine 
language and send binary instructions directly toa 
computer, but this isn’t where any sane person starts 
(or ends if they want to remain sane). 

Instead, we use a coding language to program. This 
is written using easy-to-understand functions like 
print(). These are then interpreted into machine 
language, which the computer understands. 

We’re going to use Python to learn to code. Python 
is a truly great programming language. It has a rich 
syntax that’s free from clutter, you don’t have to 
worry about things like curly braces and static typing 
that crop up in more complicated languages like Java. 

With Python, you can just create code, run it, and get 
things done. Python is one of the languages found most 
commonly inside The MagPi, so learning it here will 
help you understand lots of the code used in projects. 
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IDE and IDLE 


You don’t have to write Python programs using a text 
editor like Leafpad and run them in the terminal. 
Instead, you can use a neat all-in-one solution, known 
as an ‘IDE’ (integrated development environment). 
IDEs combine a text editor with program-running 
functionality. Often, they’ll include fancy features like 
debugging and text completion. / 
Click Menu > Programming > Python 3 (IDLE), and Above Python IDLE makes it easy to create programs and 


you’ ll get a new window called ‘Python 3.4.2 Shell:’. run them without having to use the command line 

This Shell works just like Python on the command line. Don’t forget to include the space after ‘Hello’. Choose 

Enter print( "Hello World") to see the message. File > Save As and save it as hello.py. Now press F5 on 
You can also create programs in a built-in file your keyboard to run the program. (Or choose Run > 

editor. Choose File > New File. Enter this program Run Module). [t’!] display ‘Hello World’ in the Shell. 

in the window marked ‘Untitled’: The advantage of using Python IDLE is that you can 

inspect the program in the Shell. Enter word1, and 

wordi = "Hello " you’ ll see ‘Hello’. Enter word2 and you’ ll see ‘World’. 

word2 = "World" This ability to inspect and use the variables in your 

print(word1 + word2) program makes it a lot easier to experiment with 


programming and detect bugs (problems in your code). 


Python comes 
pre-installed in the 
Raspbian operating 
system and you 
can use it at the 
command line 


SPAM 4 
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Variables are all-purpose containers that you use to store data and objects 


Python has five 
standard data types: 
@® Numbers 

@ String 

@ List 

@ Tuple 

@ Dictionary 


You'll come 
across foo’ and 
‘bar’ a lot when 
learning to code. 
These are dummy 
placeholders and 


don't mean anything. 


They could be zig 


and zag or bim and 
bam. Nobody's 
quite sure, but it 
might be related 
to the expression 
‘fubar’ from the 
Vietnamese war. 


f you’ve created a science project or 

experiment, you may have come across 

variables. In science, a variable is any factor 
that you can control, change or measure. 

In computer programming, variables are used to store 
things in your program. They could be names, numbers, 
labels, and tags: all the stuff your program needs. 

In Python, you write the name of a variable thena 
single equals sign and the word, number or object you 
want to put in it. 

Enter this code directly into the Shell: 


1 
2 


Foo 
bar 


Remember: the variable name is on the left, and the 
thing it contains is on the right. Imagine you’ve got 
two plastic cups, and you’ve scrawled ‘foo’ on the first 
and ‘bar’ on the second. You put a number 1 in foo and 
a number 2 in bar. 

If you ever want to get the number again, you just 
look in the cup. You do this in Python by just using the 
variable name: 


Foo 
bar 


You can also print out variables by passing them 
into a print function: 


print(foo) 
print(bar) 
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Variables can also be used to contain ‘strings’. 
These are groups of letters (and other characters) 
that form words, phrases or other text. 

Creating a string variable in Python is pretty 
much the same as creating an integer, except 
you surround the text with single (" ') or double 
c™ =") quotes. 

Using double quotes makes it easier to include 
apostrophes, such as print("Don’t worry. Be 
Happy" ). This line would break after ‘Don’ if you used 
single quotes — print('Don’t worry, be happy' ) 
— so use double quotes for now. 


Why variables count 

Variables make it much easier to change parts of your 
code. Say you’ve got an excellent coding job at Nursery 
Rhymes Inc and you’ve written a classic: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We’1l1 all have tea") 


The head of marketing comes in and says “our data 
shows that Polly isn’t trending with the millennial 
demographic.” You say “Huh!” and he barks “Change 
Fol ro Wolly, 

You now have to go through and change the variable 
in all three lines. What a downer! But what if you’d 
written thousands of lines of code and they all needed 
to change? You’d be there all week. 

With variables, you define the variable once and 
then use it in your code. Then it’s ready for changing 
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at any time: 
name = "Polly" 


print(name + " put the kettle on) 
print(name + " put the kettle on) 
print(name + " put the kettle on) 
print("We’11 all have tea") 


This code prints out the same classic nursery rhyme. 


But if you want to change the name of our character, 
you only have to change it in one place: 


name = "Dolly" 


...and the poem will update on every line. 


What's your type? 

When you create a variable in Python, it’s 
automatically assigned a type based on what it is. You 
can check this using the type() function. In the shell 
interface, enter: 


foo = "Ten 
bar = 10 


Now use the type() function to check the type of 
each variable: 


type(foo) 
type(bar) 


It willsay<class 'str'> for foo, and <class 
‘int'> for bar. This concept is important, because 
different types work together in a variety of ways, and 
they don’t always play nicely together. 

For example, if you add together two strings they 
are combined: 


name = "Harry" 
job = "Wizard" 
print("Yer a " 


+ job + + name) 

This prints the message “Yer a Wizard Harry”. The 
strings are concatenated (that’s a fancy programming 
term for ‘joined up’). Numbers, though, work 
completely differently. Let’s try a bit of maths: 


6 
9 


number1 
number2 


print(number1 + number2) 
Instead of concatenating 6 and 9 together to give 


69, Python performs a bit of maths, and you get the 
answer ‘15’. 
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Type casting 
So what happens when you want to add a string and 
an integer together? 


name = "Ben" 
number = 10 
print(name + number) 


You’ ll get an error message: ‘TypeError: Can’t 
convert 'int' object to str implicitly’. This error is 
because Python can’t add together a string and an 
integer, because they work differently. Ah, but not 
so fast! You can multiply strings and integers: 


print(name * number) 


It’ ll print ‘Ben’ ten times: you’l get 
‘BenBenBenBenBenBenBenBenBenBen’. 

If you want to print out ‘Ben10’, you’ll need to 
convert the integer to a string. You do this using 
a str() function and putting the integer inside 
the brackets. Here we do that, and store the result 
in anew variable called number_as_ string: 


number_as_ string = str(number) 
print(name + number_as_string) 


This code will print out the name ‘Ben10’. This 
concept is known as ‘type casting’: converting a 
variable from one type to another. 

You can also cast strings into integers using the 
int() function. This is particularly useful when you 
use input() to get anumber from the user; the input is 
stored as a string. Let’s create a program that asks for 
a number and exponent and raises the number to the 
power of the exponent (using the ‘**’ symbol): 


number = input("Enter a number: ") 
exponent = input("Enter an exponent: ") 
result = int(number) ** int(exponent) 


; \ 
Our first two variables, number and exponent, g 


are Strings, while our third, result, is an integer. 
We could just print out the result: 


print(result) 


But if we wanted to include a message, we need to 
type cast result to a String: 

print(number + " 
" + exponent + 


raised to the power 
"is " + str(result) ) 


Variables, types, and type casting can be a bit tricky at 
first. Python is a lot easier to use because it dynamically 
changes the type of a variable to match the thing you put 
in it. However, it does mean you have to be a bit careful. 


feature 


What 
to calla 
variable? 


Variable names 
should be lower- 
case words 
separated by an 
underscore ‘_’ 


They can include 
numbers, but 

must start with a 
letter. You can call 
variables pretty 
much anything, but 
there's a small list of 
reserved keywords 
you should avoid 
(magpi.cc/2h7MH1y). 
It's a good idea to 
call them something 
that will be obvious 
when you use them 
in your program, like 
‘student_name’ or 
‘person_age. 
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These comparison 
operators are 
commonly used 

in conditions 

to determine if 
something is True 
or False: 


equal 

not equal 
less than 
less than 

or equal to 
greater than 
greater than 
or equal to 
less than or 
greater than 


omputers are great because they don’t mind 
doing the same stuff over and over again. 
Their hard-working nature makes computers 
ideal for doing grunt work. 

When looking at variables earlier, we printed out 
this nursery rhyme: 


print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("Polly put the kettle on") 
print("We’11 all have tea") 


We didn’t like the repetition of Polly, so we replaced it 
with a variable. But this code is foolish in another way: 
you have to write out the same print line three times. 


We’re going to use a loop to get rid of the repetition. 


The first loop we’re going to look at is a ‘while loop’. 
In Python 3 IDLE, create a new file and save it as 


polly.py; enter the code from the top of the next page. 


We start with two variables: 


name = "Polly" 
counter = @ 


There's a massive nerd debate about whether to use spaces or tabs when 
indenting code. There are valid arguments on both sides, which you can learn in 
this clip from HBO's comedy Silicon Valley (magpi.cc/2gZdeoM). Use spaces for 
now. When you're a hardcore coder, you can make the argument for tabs. 
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Then we use the while statement followed by a 
condition: counter < 3. 

On the next line down, you press the space bar four 
times to indent the code. Don’t press the TAB key 
(see ‘Tabs or spaces®’ boxout). 


while counter < 3: 
print(name + " put the kettle on") 
counter = counter + 1 


The < symbol stands for ‘less than’. 
It checks if the item on the left is less than the 
item on the right. In this case, it sees if the variable 
counter (which starts at 0) is less than 3. This 
condition is known as ‘True’; if it wasn’t, it’d 
be known as ‘False’. 

Finally, enter the last line of code: 


print("We’11 all have tea") 


Save and run the program (press F5). It will print 
‘Polly put the kettle on’ three times and then ‘We’1] all 
have tea’. 


While, condition and indent 
Ditere are tance thine ere tie walle Statement, tire 
condition, and the indented text, organised like this: 


while condition: 
indent 


Imagine a three-way chat between all three items 
in our polly.py program: 
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While: “Hey Condition! What’s your status°” 
Condition: “True! The counter is 0. It’s less than 3.” 
Indent: “OK, guys. I’ll print out ‘Polly put the kettle 
om’ and increase the counter by 1. What’s next” 


While: “Hey Condition. What’s your status?” 
Condition: “True! The counter is now 1.” 
Indent: “OK. I’m printing out another ‘Polly put 
the kettle on’ and increasing the counter by 1.” 


This goes on till the counter hits 3. 


While: “Hey Condition. What’s your status°” 
Condition: “False! The counter is now 3, which isn’t 
less than 3.” 

While: “OK guys. We’re done!” 


The program doesn’t run the indented code, but moves 


to the single print at the end: ‘We’1l all have tea’. 


For and lists 
The next type of loop is known as ‘for’. This is 
designed to work with lists. 

Lists are a type of variable that contain multiple 
items (strings, numbers, or even other variables). 
Create a list by putting items inside square brackets: 


banana_splits = ["Bingo", "Fleegle", 
"Drooper", "Snorky" | 


Now enter banana_ splits in the Shell to view the 


list. It will display the four names inside the square 


brackets. You can access each item individually using 


the variable name and square brackets. Enter: 
banana_splits[@] 

...and you’ ll get ‘Bingo’. Lists in Python are zero- 

indexed; that means the first item in the list is [o]. 


Hereare eachof the items. Type them intohe Shell 
to get the names returned: 


PS 
go> 
@. 
d 
) 


“ 
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name = "Polly" 
counter = 90 


while counter < 3: 
print(name + " put the kettle on") 


counter = counter + 1 


print("We’11 all have tea") 


banana_splits[0] # "Bingo" 
banana_splits[1] # "Fleegle" 
banana_splits[2] # "Drooper" 
banana_splits[3] # "Snorky" 


Zero-indexed lists can be confusing at first. Just 
remember that you’re counting from o. A for loop 
makes it easy to iterate over items ina list. Create 
this program and save it as splits. py: 


banana_splits = ["Bingo", "Fleegle", 
"Drooper", "Snorky" | 


for banana_split in banana_splits: 
print(banana_split) 


It doesn’t matter what you use as the variable in 
a for loop, as long as you remember to use it in your 
indented code. You could put: 


for dude in banana_splits: 
print (dude) 


It?s common to name the list as something plural 
(such as ‘names’, ‘pages’, and ‘items’) and use the 


singular version without the ‘s’ for the ‘in’ variable: 


‘for name in names’, ‘for page in pages’, and so on. 


You must be 
careful to change 
the counter in 

a While loop, 

or you'll get an 
infinite loop. If 
you delete the 
line counter = 
counter + 1 
from our while 
loop, it will run 
forever: it never 
goes above 0, 

so the indented 
code runs over 
and over again. 
This bug is known 
as an infinite 
loop’ and is a bad 
thing to have in 
your programs. 
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You can combine 
conditions together 
using logical 
operators. 


and Both operands 
are true: (a and 
b) is True 
Any operator is 
true: (a or b) is 
True 
Checks if 
something is 
false: not (a 
and b) is True 
if both a and b 
are False. 


our programs have been slowly getting more 
powerful. We’ve learned to run instructions 
in procedural order, replaced parts of our 
program with variables, and looped over the code. 

But another important part of programming is 
called ‘conditional branching’. Branching is where a 
program decides whether to do something or not. 

Of course, a program doesn’t just decide whether or 
not to do things on a whim: we use the sturdy world of 
oeie rere: 

The start of all this is the powerful ‘if’ statement. 

It looks similar to a loop, but runs just once. The if 
statement asks if a condition is True. If it is, then it 
runs the indented code: 


if True: 
print("Hello World") 


Run this program, and it’ll display ‘Hello World’. 
Now change the if statement to False: 


if False: 
print("Hello World") 


...and nothing will happen. 

Of course, you can’t just write True and False. 
Instead, you create a condition which evaluates to 
True or False; a common one is the equals sign (==). 
This checks whether both items on either side are 
the same. Create a new file and enter the code from 
password1.py. This code is a simple program that 
asks you to enter a password; if you enter the correct 
password, ‘qwerty’, it displays ‘Welcome’. 
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Be careful not to confuse the equals logic operator 
== with the single equals sign =. While the double 
equals sign checks that both sides are the same, 
the single equals sign makes both sides the same. 
Getting == and = mixed up is acommon mistake for 
rookie coders. 


What else 


After if, the next conditional branch control you need 
to learn is ‘else’. This command is a companion to if 
and runs as an alternative version. When the if branch 
is True, it runs; when the if branch is False, the else 
branch runs. 


if True: 

print("The first branch ran") 
else: 

print("The second branch ran") 


Run this program and you’ll see ‘The first branch 
ran’. But change True to False: 


if False: 

print("The first branch ran") 
else: 

print("The second branch ran") 


...and you’ll see ‘The second branch ran’. Let’s use 
this to expand our password program. Enter the code 
from password2.py. 

Run the program again. If you get the password 
correct now, you’ll get a welcome message. Otherwise, 
you’ ll get an ‘incorrect password’ message. 
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Elif 

The third branching statement you need to know 

is ‘elif’. This statement stands for ‘else if’, and sits 
: 2 

between the if and else statements. Let’s look at an if attempt 

elif statement. Enter this code: 


password = "qwerty" 
attempt = input("Enter password: ") 


== password: 
print( "Welcome" ) 


if False: 

print("The first block of code ran") 
elif True: 

print("The second block of code ran") 


password = "qwerty" 
attempt = input("Enter password: ") 


else: 
print("The third block of code ran") if attempt == password: 
print( "Welcome" ) 
else: 


Run this program and you’ ll find it skips the first if 
statement, but runs the elif statement. You’ll get ‘The 
second block of code ran’. 

The else statement doesn’t have a True or False 


print("Incorrect password!") 


condition; it runs so long as neither the if or elif Writing FizzBuzz 
statements are True. (Note that the else statement here, The brief for our FizzBuzz is to print the numbers from 1 to Comments 
as always, is optional; you can just have if and elif.) 100. If anumber is divisible by three (such as 3, 6, and 9), 

But what happens if you change both the if and elif then you print ‘Fizz’ instead of the number; if the number Amark of a good 
conditions to True? Give it a try and see whether just is divisible by five, you print ‘Buzz’ instead. programmer is to 
if runs, or elif, or both. Experiment with removing the But if a number is divisible by both 3 and 5, such as encornmantcin 
else statement and play around. It’ll help you get the the number 15, then you print ‘FizzBuzz’. your programs. 
hang of the if, elif, and else statements. We’re also introducing a new element in FizzBuzz: Connente ate 

; the ‘and’ statement. This checks if two conditions used to explain 
FizZBuzz are both True: that the number can be divided by bits of your 
We’ re going to show you a common program used both 3 and 5. It only returns True if both conditions program to 
in computer programming interviews. It’s a classic elles Ana humans. They 
called ‘FizzBuzz’, and it shows that you understand if, There are three main logical operators: and, or, are completely 
else, and elif statements. and not. The first two are relatively straightforward, ignored by 

First, you need to know about the modulo operator but the ‘not’ operator can be more confusing at first. the computer. 
(%). This is used to get the remainder from a division Don’t worry about it too much; you’!] get the hang of In Python, you 
and is similar to a divide operator. Take this function: it with practice. Ear eC arnincnt 

Enter the fizzbuzz.py code from page 25 to practise imecine hoch 

1@ / 4 == 2.5 using if, else, and elif elements and logical operators. 


symbol (#). It can 
be ona line on 

If we use a modulo instead, we get this: Wy, RN it own, or it can 

@ come right after 

10 % 4 == nw ny a line of code. As 


soon as Python 
Modulo turns out to be handy in lots of ways. You hits the # it'll 


can use% 2 to figure out if a number is odd or even: stop translating 


whatever follows 
10 % 2 == © # this is odd 


11 % 2 == 1 # this is even 


into machine code. 
Comments help 
other users to read 
your program, but 
they will also help 


This program works out if a number is odd or even: 


number = 10 you understand 


what you're doing 
if number % 2 == 


print("The number is even") 
else: 
print("The number is odd") 


(long after you've 
forgotten). It's 

a good habit to 
use comments in 


your programs. 


OK let's move on to BizzBuzz 
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Create the building blocks of code and make more robust programs 


ou’ve come a long way since your first 
“Hello World’. Your programs now check 
for conditions and loop over themselves. 

You’re now writing programs that are known as 
‘Turing complete’, named after Alan Turing, the father 
of computer science and artificial intelligence, who 
hacked the German Enigma code in WWII. 

Now we’re going to take things a little further. 
We’re going to introduce you to a form of modularity 
called functions. 

Functions are blocks of code that you write once 
and can repeat anywhere. It’s a little like being able to 
write a block of text once, and then paste it whenever 
you need it. 


Spotting a function 

Python is packed with built-in functions, 
and you’ve already been using them in your 
programs. Commands like print(), len(), and 

type() are all functions. They’re easy to spot: a 

small command Starting with a lower-case letter 

MH and followed by a pair of parentheses ‘()’. 


You can browse or download a copy of the Python 
documentation directly from the Python website 

at python.org/doc. Python has a whole bunch of 
built-in functions. You can view a list of all the built-in 
functions on the Python documentation website 
(magpi.cc/2gPsGk3). 
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Using functions 
Let’s take a look at a function called abs(). It stands 
for ‘absolute’, and returns the absolute value of any 
number you pass into it (the bit you pass in is called 
the ‘argument’). 

An absolute number is the positive of any number, so 
if you write abs(-2) you get 2 back. Try this in the Shell: 


abs(2) # returns 2 
abs(-2) # returns 2 


You can store the returned result as a variable: 
positive_number = abs(-10) 


We find it easier to read a function backwards, from 
right to left. The value is passed into the parentheses, 
then the function cranks it and returns a new value. 
This is passed left and stored into the variable. 


Defining a function 

The great thing about Python is that you don’t just 
use the built-in functions: you get to make your own. 
These are called ‘user-defined functions’. 

You create a function using the def keyword, 
followed by the function name and parentheses. 
Inside the parentheses, you list the parameters. 
These are the same as the arguments, only inside the 
definition they are called ‘parameters’. 


def function(parameter): 
return parameter 


raspberrypi.org/magpl 


Our function here doesn’t do anything; it simply 
accepts a parameter and returns it. 

At the end of the function definition is a colon (:). 
The function code is indented by four spaces, just like 
a loop or if/else branch. 

The code inside the indentation runs when you call 
the function. Functions typically include a return 
statement which passes back an expression. 


Working functions 
We’re going to create a function that prints the lyrics 
to Happy Birthday. 

Type out the happy_birthday. py code from the 
listing, then rum it. In the Sire} enter, 


happy_birthday("Lucy” ) 


This function call uses the string ‘Lucy’ as the 
argument. This string is passed into the function as 
the parameter and is then available for use in the 
indented code inside the function. 


Return statements 
Many functions don’t just run a block of code; they 
also return something to the function call. 
We saw this in abs(), which returned the absolute 
value of anumber. This can be stored in a variable. 
In fact, we’re going to recreate the abs() function, 
so you can see how it’s working behind the scenes. 
In maths, you invert a positive/negative value by 
multiplying a negative number by -1, like this: 


10 * -1 = -10 
-10 * -1 = 10 


We need to create a function that takes a number 
as a parameter and checks if it’s negative. If so, it 
multiplies it by -1; if it’s positive, it simply returns the 
number. We’re going to call our function absolute(). 

Enter the code in absolute.py. When the function 
hits either of the return statements, it returns the 
value of the number (either on its own or multiplied 
by -1). It then exits the function. 

Run the absolute. py code and enter the following 
ithe Shell: 


absolute(10) 
absolute(-10) 


Our last program listing is a classic known as 
‘FizzBuzz’; as mentioned on page 23, it will help you 
to understand if, else, and elif. 

You also need to know the modulo operator (%) for 
FizzBuzz. This operator returns the remainder from a 
division. If you don’t know how modulo works, watch 
this video (magpi.cc/2h5XNRO). 

Now work through the code in fizzbuzz.py. 
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def happy_birthday(name): 


Happy -birthday. py 


count = @ 
while count < 4: 
if count != 2: 
print("Happy birthday to you") 
else: 


print("Happy birthday dear " + name) 


count += 1 


def absolute(number): 
if number < 0: 
return number * -1 
else: 
return number 


(lbsclute.py 


count = 9 
end = 100 


fizzbuzz.py 


while count < end: 


if count % 5 == 0 and count % 3 == @: 
print("FizzBuzz" ) 
elif count % 3 == @: 


print("Fizz") 
elif count % 5 == 

print( "Buzz" ) 
else: 

print(count) 


count += 1 


Going further 


Here are some resources you will find useful. 


GPIO Zero Essentials — magpi.cc/2bA3ZP7 

This Essentials guide book explains how the GPIO Zero Python module 
provides access to a bunch of features. These are used to hook up 
electronics to your Raspberry Pi via the GPIO pins. 


FutureLearn - magpi.cc/2hs5Sthf 
The Raspberry Pi Foundation has two new online training courses: 


Teaching Physical Computing with Raspberry Pi and Python, and 
Teaching Programming in Primary Schools. 


Learning Python - magpi.cc/2h2zopWC 

This tutorial provided by The Raspberry Pi Foundation 
has files you can download. You download the file, 
called intro.py, using this command in a Terminal: 

wget http://goo.gl/@ZDOdX -O intro.py 
--no-check-certificate. Open : 

the intro.py file in IDLE; allthe —_— 

instructions are in the file. . 


January 2017 MdgPi = 25 


Importing 


Stand on the shoulders of giants by importing 
other programmers’ code 


Pygame 


If you want to 

learn more about 
Pygame, check out 
Make Games With 
Python, our free 
Essentials Guide to 


the Pygame module. 


magpi.cc/2h2movh 


Magh 
MAKE a a << 


is HEATE YOUR Ow H 
ENTERTAINM ENT WITE 


. 
ik 


his being the modern world, you’re not 
supposed to do all the work on your 

own. Instead, you will often stand on the 
shoulders of other programmers who have done the 
eroundwork for you. 

Your programs can import code created by other 
people using the import statement. This enables 
you to import modules and use their functions — only 
they’re now known as ‘methods’. 

You import the module at the command line, and 
then access the functions using dot notation. This is 
where you list the module, followed by a dot (.), then 
the method. 

A common module to use is math. This allows you 
to access lots of maths methods. Open a Python Shell 
and enter: 


import math 


You now have access to all the methods in math. 
You won’t notice any difference, but if you type: 


type(math) 
...it will say ‘<class 'module'>’. Let’s try out dot 
notation now. Type math followed by a dot and the 
name of the method (function) you want to use: 

math.sqrt(16) 

This gives the square root of 16, which is 4. 


Some methods have more than one argument. The 
math.pow() method raises a number to an exponent: 
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math. pow(64, 3) 


This returns 262144.0. 

You can also access constant values from a module, 
which are fixed variables contained in the module. 
These are like functions/methods, but without 
tie Parentneses. 


math.pi 


This returns pi to 15 decimal spaces: 
3.141592653589793. 


math.e 


This returns Euler’s number to 15 decimal spaces: 
2.718281828459045. 

It’s also possible to import methods and constants 
from modules using from. This enables you to use 
them inside your programs without dot notation 
(like regular functions). For example: 


from math import pi 
from math import e 
from math import pow 


Now, whenever you type pi or e, you’ 1l get pi and 
Euler’s number. You can also use pow() just like a 
regular function. You can change the name of the 
function as you import it with as: 


from math import pi as p 


Now when you enter p you’ ll get pi to 15 decimal 
spaces. Don’t go crazy renaming functions with as, 
but it’s common to see some methods and constants 
imported as single letters. 

By creating your own functions, and importing 
those created by other people in modules, you can 
vastly improve the capabilities of your programs. 

We’re going to take everything we’ve learnt and use 
it to create a game of Pong; this is one of the world’s 
first videogames. 

Write out the code carefully in pong.py. Here you’11 
find variables, functions, loops, and conditional 
branching: all the stuff we’ve talked about. Hopefully, 
you’ll now be able to decipher most of this code. 

If you’re interested in taking Pong further, this 
program is similar to a version of a Pygame program 
by Trever Appleton (magpi.cc/2hgkOUX). His version 
has a scorecard and more advanced code. We’ve kept 
ours simple so it’s easier to start with. 

Hopefully this isn’t the end of your Python, or 
programming, journey. There are lots of places 
you can learn programming from. And we’ll have 
more programming resources for you in every issue 
of The MagPi. 
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. import pygame, sys 


Q@2. from pygame.locals import * 

03% 

Q@4. # Set up game variables 

Q@5. window_width = 400 

Q6. window_height = 300 

Q@7. line_thickness = 10 

Q@8. paddle size = 5@ # try making this smaller for a harder game 

Q9. paddle offset = 20 

10. 

11. # Set up colour variables 

12. black = (@ ,@ ,@ ) # variables inside brackets are ‘tuples’ 

13. white = (255,255,255) # tuples are like lists but the values don't 
change 

14. 


. # Ball variables (x, y Cartesian coordinates) 

. # Start position middle of horizontal and vertical arena 
. ballX = window_width/2 - line_thickness/2 

. ballY = window_height/2 - line_thickness/2 


. # Variables to track ball direction 


21. ballDirX = -1 ## -1 = left 1 = right 

22. ballDirY = -1 ## -1 = up 1 = down 

23% 

24. # Starting position in middle of game arena 

25. playerOnePosition = (window_height - paddle size) /2 
26. playerTwoPosition = (window_height - paddle size) /2 
27% 

28. # Create rectangles for ball and paddles 


. paddlei = pygame.Rect(paddle_offset,playerOnePosition, line_ 
thickness, paddle size) 

. paddle2 = pygame.Rect(window_width - paddle offset - line_ 
thickness, playerTwoPosition, line_thickness, paddle_size) 

. ball = pygame.Rect(ballX, ballY, line_thickness, line_thickness) 


. # Function to draw the arena 
. def drawArena(): 
35. screen.fill((@,0,@)) 

# Draw outline of arena 

pygame.draw.rect(screen, white, ( 
(0,0), (window_width,window_height)), line _thickness*2) 

# Draw centre line 

pygame.draw.line(screen, white, ( 
(int(window_width/2)),®),((int(window_width/2)),window_height), ( 
int(line_thickness/4) )) 


. # Function to draw the paddles 


42. def drawPaddle(paddle): 

43. # Stop the paddle moving too low 

44. if paddle.bottom > window_height - line thickness: 
45. paddle.bottom = window_height- line_thickness 
46. # Stop the paddle moving too high 

47. elif paddle.top < line_thickness: 

48. paddle.top = line_thickness 

49, # Draws paddle 

58. pygame.draw.rect(screen, white, paddle) 

BL. 

52. # Function to draw the ball 

53. def drawBall(ball): 

54. pygame.draw.rect(screen, white, ball) 

Sas 

56. # Function to move the ball 

57. def moveBall(ball, ballDirX, ballDirY): 

58. ball.x += ballDirXx 

=r ball.y += ballDirY 

60. return ball # returns new position 

61 

62. # Function checks for collision with wall and changes ball 


direction 
. def checkEdgeCollision(ball, ballDirX, ballDiryY): 


if ball.top == (line_thickness) or ball.bottom == (window_ 
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114. 
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height - line_thickness): 
ballDirY = ballDirY * -1 
if ball.left == (line thickness) or ball. 
right == (window_width - line thickness): 
ballDirX = ballDirXx * -1 
return ballDirxX, ballDirY # return new direction 


Pong-py 


# Function checks if ball has hit paddle 
def checkHitBall(ball, paddle1, paddle2, ballDirX): 
if ballDirX == -1 and paddlei.right == ball.left and 
paddle1.top < ball.top and paddlei.bottom > ball.bottom: 
return -1 # return new direction (right) 
elif ballDirX == 1 and paddle2.left == ball.right and 
paddle2.top < ball.top and paddle2.bottom > ball.bottom: 
return -1 # return new direction (right) 
else: 
return 1 # return new direction (left) 


# Function for AI of computer player 
def artificialIntelligence(ball, ballDirX, paddle2): 
# Ball is moving away from paddle, move bat to centre 
if ballDirX == -1: 
if paddle2.centery < (window_height/2): 
paddle2.y += 1 
elif paddle2.centery > (window_height/2): 
paddle2.y -= 1 
# Ball moving towards bat, track its movement 
elif ballDirX == 1: 
if paddle2.centery < ball.centery: 
paddle2.y += 1 
else: 
paddle2.y -=1 
return paddle2 


# Initialise the window 
screen = pygame.display.set_mode((window_width,window_height) ) 
pygame.display.set_caption('Pong') # Displays in the window 


# Draw the arena and paddles 
drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(bal1) 


# Make cursor invisible 
pygame .mouse.set_visible(@) 


# Main game runs in this loop 
while True: # infinite loop. Press Ctrl-C to quit game 
for event in pygame.event.get(): 
if event.type == QUIT: 
pygame.quit() 
sys.exit() 
# Mouse movement 
elif event.type == MOUSEMOTION: 
mousex, mousey = event.pos 
paddlei.y = mousey 


drawArena() 
drawPaddle(paddle1) 
drawPaddle(paddle2) 
drawBall(bal1) 


ball = moveBall(ball, ballDirX, ballDirY) 
ballDirX, ballDirY = checkEdgeCollision( 
ball, ballDirX, ballDirY) 
bal1DirX = ballDirX * checkHitBall( 
ball, paddle1, paddle2, ballDirX) 
paddle2 = artificialIntelligence (ball, ballDirX, paddle2) 
pygame.display.update() 
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FREE 


Subscribe in print for six or 12 months to receive this stunning free gift 


Subscribe today and receive: 
A free Pi Zero v1.3 (the latest model) 
A free Camera Module connector 
A free USB and HDMI cable bundle 


Delivered with your first issue! 


Other benefits: 


Save up to 25% on the price 
Free delivery to your door 
Exclusive Pi offers & discounts 


Get every issue first (before stores) 
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MATT LONG 
& MARK NICHOLS 


Matt Long and Mark Nichols (pictured) 
are Microsoft cloud solution architects 
who work on the Pegasus Mission. 
pegasusmission.com 


EGASUS 
tHE NORTH 
m@ AMERICAN 
SIrAGLE 


The wheels are 
milled from 
solid aluminium 


Meee = [his land speed record-attempting jet car has 
wee a Raspberry Pi sitting right behind the driver 


of over 800mph 


It consumes up 


ae ae nside the cockpit of one The current world record stands Brandyn Bayes, team member. 
during a run of the most remarkable at 763.035mpnh. This was set in “Starting with the battered 
machines on Earth sits a October 1997 by British Royal Air hulk of a Cold War-era jet 
Raspberry Pi. Force pilot Andy Green, driving his __ plane, we have developed one 
The North American Eagle jet DOWwencd mich ss @ cal, of the most sophisticated racing 
is an ongoing attempt by an “We have a mission to break machines ever.” 
American team to reclaim the the World Land Speed Record of The North American Eagle 
land speed record. 763mph (1227.93km/h),” says started life as a Lockheed F-104 
Starfighter. “It was used as a chase 
Right Sensor data 
fromnncidaine plane,” reveals Brandyn. These are 


cockpit is gathered 


planes used to follow experimental 
by a Raspberry Pi 


aircraft and measure engineering 
data. It followed some of the 
ereatest experimental aircraft in 
history, among them the X-15 
and the Northrop-Grumman B-2 
Stealth Bomber. 

The particular F-104 that has 
been transformed into a superfast 
car was designated 56-0763. By 
1998 it was “beyond a shambles,” 
says Brandyn. “The North American 
Eagle project gave it new life, so 
that it could once again be one of 
the fastest machines on Earth.” 
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The Raspberry Pi is placed 
inside the cockpit, right 
behind the driver's head 


Aluminium wheels are 
attached to the jet, 
turning it into a car 


The North American Eagle 
is a Lockheed F-104 jet 
with its wings removed 


High-speed Pi a Microsoft cloud solutions Mark. That device was a Raspberry 
While North American Eagle is architect) to the North American Pi 3 running Windows 10 IoT 
eunning for the speed record, the Eagle project. “We asked to join Core. The software was written 
Pegasus Mission behind it usually the North American Eagle team,” in C# as a Universal Windows 
has its eyes to the sky. Mark tells us. Platform application. 

“Pegasus Mission uses a high- The Pegasus Mission balloon “Microsoft has been a partner 
altitude balloon as a delivery “provides a rich and interesting supporting North American Eagle 


for quite a while,” says Mark. 


“Volunteer her to build 
The North American Eagle i eee an 
started life asa Lockheed mobile, and web app capability.” 


The main aim of the Raspberry 


F-104 Starfig hter Pi was to analyse the car during its 


test run. “It gathered real-time 
sensor data,” says Mark. GPS, 


system to carry a payload,” experience for users viewing atmospheric, acceleration, and 
reveals Matt Long, a Microsoft the flight as it happens,” sound level data was gathered by 
cloud solution architect. Mark explains. “We started with the Raspberry Pi and sent to the 
The balloon is “packed with the idea that the Pegasus team Microsoft cloud. 
meteorological sensors to stream could provide a real-time view The Pegasus team could 
telemetry and control flight of what was happening with the “evaluate the benefits of 
operations in real time.” vehicle to a global audience.” real-time data reporting and 

It’s this expertise in real-time “For this project I builtacustom analysis in combination with the 
communication that attracted device that was installed in the goals of the North American Eagle 
Matt and Mark Nichols (also cockpit of the vehicle,” reveals team,” he explains. 
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The more entertaining aspect 
was the real-time interaction with 
observers during the test run. 
“People using [our mobile] apps 
could also send goodwill messages 
through the cloud and out to the 
car, where they were shown on 
an LCD display,” says Mark. The 
messages were displayed ina 
screen behind the driver. 

Mark also placed a GoPro camera 
behind the driver to record the 
user messages on the screen. “The 
driver could not see them while 
driving,” he explains, “as that 
would be a distraction, but the 
camera could see the display and 
the cockpit.” 

Naturally, the team needed to 
filter out inappropriate messages. 
“The system is configured to 
check a user message for profanity 
by calling a third-party SaaS 
service, Web Purify,” says Matt. 
“Tf the message passes, then it’s 
sent back into the system and 
onto the device in the cockpit 
for display. 


“The extra benefit [of the 
camera] is that it also gave us a 
front view out of the cockpit,” 
continues Matt. This video was 
used during a debug session 
with Jessi Combs (one of the test 
drivers) after her first run. 

“We also invested in two drones 
to record video, which gave us a 
ereat field of view during runs, as 
well as recording other aspects of 
the event and its remote location,” 
adds Matt. 


Technology matters 
“The technology that makes this 
real-time and scalable is Azure,” 
Matt reveals. 

“Azure provides a delivery 
mechanism for global 
communications in real time,” 
he explains. “We can capture 
the telemetry from the device, 
messages for users, and analyse 
or even replay data exactly 
as it occurred.” 

Matt tells us that North 
American Eagle’s comprehensive 


NOrth American Fagle 


Waits we? re 
Jo how fast 
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on-board telemetry can be 
uploaded to Azure and viewed as 
a time-series event. “A team of 
around 20 Microsoft volunteers 
built mobile applications on 
Xamarin for iOS, Android, and 
Windows mobile, and a website in 
Azure App Services.” 

“Since day one, people have said 
this project was just a little crazy,” 
comments Brandyn. “Perhaps 
that’s a bit of an understatement, 
yet we couldn’t agree more. It’s 
that very adventuring spirit that 
has pushed us to continue to go 
further, to do something few would 
ever dare.” 

Microsoft Research enabled the 
team to stream live telemetry to 
fans as the vehicle raced across 
the empty desert. “We were 
able to share over 500 million 
points of telemetry to over 4,500 
people on Jessi’s first run alone,” 
reveals Brandyn. 

“We received messages from 
users in Australia, New Zealand, 
UK, France, Norway, and the USA. 


One of the users watching Jessi 
Combs’s first run sent a message 
to the device with her approximate 
top speed before she stopped. 
“While we didn’t break the 
records we had hoped for,” says 
Brandyn, “what we found was a 
reminder of why we love racing: 
the undeniable rush of adrenaline 


when things go right, despite the 
setbacks along the way.” 

“The North American Eagle 
team, Ed Shadle, and Jessi Combs 
have pushed themselves to the 
limit in the race for a land speed 
record,” adds Matt. “In the process, 
they have made us all proud 
members of the human race.” 


The 
North American 
Eagle uses its jet 
engine to achieve 
astonishing speeds 
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CLODAGH O’MAHONY 


Masters student and newly appointed 
teacher of Creative and Innovative 
Design Technology, Clodagh is alsoa 
master rower and archer. 
clodaghomahony.com 
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Clodagh's 
Instagram 
documented 
the entire 
process 


The dress was 
redesigned 

to improve 
comfort and 
functionality 


The Raspberry 
Pi records 
touch and 
keywords 


It then uploads 
this data to its 
SQL database 


Conductive 
thread was 
used to create 
‘sectors’ 


n her website, Clodagh 

O’ Mahony describes 

herself as a “multi- 
disciplinary designer with 
experience in product, graphic, and 
UX/UI design, as well as illustration 
and media production.” 

Having completed her BSc in 
Product Design and Technology at 
the University of Limerick, Clodagh 
went on to study for her master’s 
degree at the same establishment, 
this time in Interactive Media. This 
is where the Raspberry Pi comes in. 

FOR mentite sis prejceir 
Clodagh created a dress and an 
accompanying website to comment 
on the progression of social media 
interaction — the idea that it’s 


MagPi January 2017 


All components are located 
at the back of the dress 


Different colours represent 
touch to different body 
parts, recording this data 
to the Raspberry Pi 


The aim was for a dress that 
would still be fashionable 
and comfortable, despite 
the additional tech 


A SPECULATIVE 
SOCIAL MEDIA 
PLATFORM 


Clodagh O’Mahony’s university thesis project records touch 
and voice data to award points for social interaction 


getting harder and harder to ‘hide’ 
on platforms such as Facebook 
and Twitter due to the sheer 
amount of personal information 
we pump into our timelines. 
Whereas a person could once 
create an entirely new persona 
through the predominantly text- 
based interaction of blogs and 
chat rooms, we now live a more 
visual existence online. Photo, 
video, and emojis have replaced 
textual communication, adding 
more ‘face’ to the name, and 
inevitably adding more reality. 
With this in mind, Clodagh set out 
to design “a wearable connected 
platform that introduces what 

is sold as a ‘purer’ form of social 


media. The quantitative data 
means users would have to 

go to extraordinary lengths 

to misrepresent their lives, 
thereby making its information 
more reliable than that of 

its competitors.” 

Clodagh created a corporation 
named ‘QBee’, an abbreviation of 
Queen Bee, with the associated 
honeycomb theme playing a 
Significant part in the look of 
both the dress and website. This 
corporation, if given true life, would 
provide a range of wearable tech — 
similar to her dress — that would 
allow for the recording of social 
interaction data, updating it to the 
wearer’s online QBee account. 
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>STEP-01 


The aim of the build is to record 
physical interactions between the 
wearer and the people with whom 
they come into contact in the real 
world. A touch to the waist, for 
example, would be recorded with 
a certain set of points, whereas 
a touch to the back would record 
another. Alongside this physical 
interaction data, a microphone 
is used to listen out for any of a 
series of keywords that are listed 


QBEE 


Projects 
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>STEP-02 


activates the dress to glow a warm 
PUBplera touch te tne ip rlinms 1 
ereen, and soon. 

The dress went through a couple 
of redesigns throughout the process 
of the build, all documented on 
Clodagh’s Instagram account 
(magpi.cc/2eJgHuZ), allowing for 
improvements to cost, comfort, and 
usability factors. The original dress, 
though fitting exactly to the design 
plan of colour-related sectors, 


A wearable connected platform 
that introduces what 1s sold as 
a purer form of social media 


as either positive or negative, 
whereupon the relevant point 
data can be recorded. 

The build incorporates an 
Adafruit 12-key capacitive touch 
sensor breakout board, Pimoroni 
Blinkt, fibre optics, and a Raspberry 
Pi, all fitted within a beautiful 
hexagonal 3D- printed casing. 

Clodagh’s aim was to use the 
Blinkt and fibre optics to add 
colour to the data recording: 
the touch of a hand to the waist 
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wasn’t very comfortable. This led 
Clodagh to create another. Though 
the second dress doesn’t offer 
exactly the same functionality, 

it does look the way she wanted, 
and still uses the Blinkt, though 

in a slightly different manner. 
Touch the new dress in any of 

the sectors and the Blinkt runs 
through a rainbow sequence until 
the touch is concluded: it is enough 
to demonstrate the idea of data 
recording and capacitive touch. 
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Showing the dress off as part of her thesis 


eaahied aes 


Above Clodagh experimented with multiple 3D-printed cases, 
finding the ideal location for the tech to be housed 


January 2017 MagPi | 35 


Projects 


SELF-PLAYING 


This handcrafted wooden instrument can play any MIDI tune 


» Wendell first 
tried making 
a MIDI wine 
glass player 


» The organ took 
about three 
years to build 


» He bought the 
blower on eBay 
for $80 


» Pipes range 
from 9 to 40 
inches in length 


» He's now 
rebuilding 
the organ in 
solid oak 


xperienced woodworker 
Wendell Kapustiak needed 
all his carpentry skills to 
create this impressive self-playing 
pipe organ (magpi.cc/2fMacLy). 
“The most fundamental [problem] 
was that I had no idea howa 
pipe organ actually worked,” 
admits Wendell, who eventually 
based its mechanical workings 
on a project by Matthias Wandel 
(woodgears.ca). The most difficult 
part was making the 42 wooden 


Each of 42 handcrafted 
wooden pipes produces ii) 
a different musical note oa al 


When triggered, solenoids 
open their respective pipe 


valves to play notes 


The solenoids are wired 
indirectly to an Arduino Due 
receiving data from a Pi 
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pipes, which span three-and- 
half octaves, since each one has 
unique dimensions to produce the 
correct pitch. For this, Wendell 
used information provided by 
Raphi Giangiulio’s YouTube videos 
(youtu.be/-mibK_Dp-ZY). 

The pipes are linked via PVC 
plumbing to a wind chest powered 
by a Kooltronic KBR125 blower, 
as used in data centres. “I had 
originally tried a small shop vac as 
a blower,” Wendell tells us. “It had 


two problems. The first was that it 
was very noisy; the second was that 
it ran hot. When I enclosed it ina 
box to control the noise, it got so 
hot that my first one burned out.” 
To make it play, each wooden 
pipe has a valve opened and 
closed by a solenoid, triggered 
from an Arduino Due via a power- 
boosting driver board. The ‘brains’ 
of the operation is a Raspberry 
Pi, which performs three main 
functions. As well as a graphical 


-_ 


raspberrypi.org/magpi 


SELF-PLAYING PIPE ORGAN 


na i 


TELMEL 


090000000004 900 


gas) 
bss “ 
ap 88.588) Naat ti 
[avavavara 


Te lLalel tel alen ee 


t . 
. a : 
a ain CO Oe 
a 


mv. 
= we oy 
>< 
3 i 2 , 4 [ ig8 


6040 


oi 


888 


bi 
38 


jah ie ental a 
——— 


2960000 


Aon roles 


+a! 54 


a 


ee 
slalloghs YOO" WQS: O00 


oo 


user interface for selecting music 
to play, it converts the MIDI 
binary files into delay/note-on/ 
note-off commands, plus musical 
directions: “Ihe Raspberry Pi 
takes into consideration tempo 
changes and any other subtleties 
in note timing, and converts them 
into a number of microseconds,” 


The Raspberry P1 takes into 
consideration tempo changes 


Above A home-built driver board with 
transistors is used to boost the power from 
the Arduino output to trigger the solenoids 


a Sample in about 20 minutes and 
it worked a treat.” 

Another issue involved the 
spacing of the pipes, which 
Wendell discovered could interact 
with each other if placed too 


and any other subtleties 


explains Wendell. “In this way, 
the Pi has done all the heavy 
lifting as far as calculations go.” 
Another Python program is then 
used to send this data to the 
Arduino via USB. 

While the high-tech side of the 
project proved fairly hassle-free, 
the physical engineering was more 
problematic. One difficulty was 
the wind pressure regulator, which 
originally had a bellows-type 
mechanism. “I was trying out a few 
different designs, trying to develop 
one that was mechanically simple 
and dependable while producing a 
very stable pressure.” Fortunately, 
Wendell’s friend Jim, a retired 
HVAC engineer, stopped by and 
suggested a new approach, using a 
weight-controlled door as used in 
ventilation systems. “I whipped up 
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closely together. “I suddenly 
understood why organs were 
designed with the pipes in a few 
rows but spread out, not bunched 
together.” He also reversed the 
overall layout to put the solenoids 
at the front, so listeners can see 
them operating the valves. He 
has since added some LEDs: “Tt 
makes it much easier to follow 
what’s going on than just watching 
the solenoids.” 

The finished pipe organ 
generated a lot of interest from 
attendees at the Orlando Maker 
Faire. “I think most people were 
able to walk away with some 
level of insight as to how the 
combination of the old technology 
of the pipe organ and the new 
technology of the computer and 
microcontroller fit together.” 


Projects 


MAKING SWEET 
PIPED MUSIC 


>STEP-03 
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BRIAN BRANDAW 


A 25-year veteran of the 

IT industry, Brian is highly 
experienced in Linux and 
enjoys playing around with 
his Pi at home. 


LEVEL MONITOR 


Automated water collection and monitoring through the power of 
Raspberry Pi —- and the winner of Initial State’s PloT Challenge 


The system is wired up 
to a ProtoZero board 
on the Pi Zero 


he Raspberry Pi is no 
stranger to automation, 


> It took 
four months 
on-and-off 
to build 


> Brian reckons 
he could 
rebuild one 
in about 
four hours 


> The ProtoZero 
board allows 
you to build 
circuits direct 
to the GPIO 


> It's accessible 
and can be 
controlled 
wirelessly 


> Brian has other 
Pis monitoring 
parts of his 
property 


and if you’ve read 
enough issues of this magazine 
you’ ll have seen plenty of home 
automation projects that use it. 
This automation project is a little 
different, though: measuring the 
water level in a couple of water 
tanks, a solution devised by Brian 
Brandaw from Texas. 

“Being on a rural lot, we rely on 
a private well for our water,” Brian 
explains. “The quality is quite poor 
and the well has been unreliable 
at times. We took advantage of 
the metal roof on the barn and the 
existing rain gutters and installed 
two rainwater collection tanks. 

We added standard float valves to 
these to fill water troughs for the 
horses. This arrangement worked 
well until we ran out of water in the 
tanks! There is no easy means to 
track tank level.” 

All the traditional methods are 
visual, requiring you to go out to 
the tanks to check them on a fairly 
regular basis, although some can 
be used at a distance. 

“T wanted to devise a means 
to monitor tank levels to know 
when things were running low,” 
continues Brian. “We can also 
measure water consumption by 
looking at how the water level 
changes over time.” 
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The pressure sensor 
gets its reading 
from the tank 


It can be operated 
wirelessly from 
another system 
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WATER TANK LEVEL MONITOR 


MONITORING WATER 


Under pressure 
The pressure sensor at the bottom of 
the tank is constantly under pressure, 
although this varies as the water level 
goes up and down. 


As we live in 2016, computer- 
aided monitoring was on the 
table. Brian’s method was rather 
ingenious: instead of measuring 
the water level at certain points, he 
measured the pressure of the water 
at the bottom of the tank. Witha 
few extra calculations to take into 


I wanted to devise a means to 
monitor tank levels to know 
when things were running low 


account atmospheric pressure and 
the size of the tank, the volume of 
water could be calculated. 

“Tused a Pi Zero as the 
platform to read the pressure 
sensor (via an analogue-to- 
digital converter), calculate the 
tank volume, and post the data to 
InitialState for dashboarding and 
alerting,” Brian tells us. 

His experience with Linux 
throughout his career made him 
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Light reading 

The Pi Zero reads the voltage levels on the 
two outputs with the help of an analogue- 
to-digital converter. The GPIO cannot 
measure it natively. 


more comfortable creating the 
project, basing it on a Similar 
solution employing an Arduino 
that he’d seen a few years ago. This 
way he managed to save money on 
proprietary solutions as well. 

“Tt was tricky to build, but not 
because of the complexity of the 


solution,” Brian notes. “The box 
I chose is rather small, so it took 
some time to squeeze it all in 
there. The biggest challenge is the 
tight space on the ProtoZero board. 
I’m not the best at soldering, so 
it’s been slow going at times.” 
Brian reports that the solution 
works well, with only a minor 
repair required after he damaged a 
connection. In the future he plans 
to upgrade these connectors to 


Projects 


Simple geometry 

The Pi Zero uses fluid dynamics and the 
measurements of the tank to determine the 
volume of the water in the tank. This can be 
charted to keep track of consumption. 


Above The whole thing is connected to the 
bottom of the tank in a small grey box 


make them a little more rugged, 
but otherwise it looks like his 
project has helped out enormously 
with his water supply. 
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CEEDuniverse 


CEEDuniverse is a world of fantasy 
grounded in computing reality! After 
crash landing on a strange new planet 
you will first encounter ‘drag and drop 
coding puzzles thal improve your 
computational thinking skills. 


Discover more about the planet you ve 
landed on and the civilisation that used 
to inhabit it while learning harder and 
more complex concepts in fun and 
engaging ways! Before long youll be 
writing your own conditional 
statements, loops and functions. Find 
out more about CEEDuniverse at 
www.pi-top.com 


pi-top CODER 


Influenced by the workflow of makers 
and hackers, pi-top presents 
pi-topCODER - an integrated code editor 
which allows you to learn, write and test 
code all in one view. With intuitive 
syntax highlighting, dynamic views and 
customizable themes it makes for a 
versatile learning tool for your projects. 


pi-topCODER also has every Raspberry Pi 
Foundation lesson plan created and will 
track and save your progress as you go 
through dozens of fun hardware and 
software projects. 
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Add-on Board for your pi-top or with pi-topSPEAKER! 

pi-topCEED that allows you to 

prototype electronics. Create a e Modular design, attach up to three 
Weather Station, HAM Radio, Heart in a row to give true stereo sound. 
Rate Monitor, or integrate any e 2W per module 

Arduino based maker kits into your e Left, Right and Mono mix selection 
own Raspberry Pi compatible e High quality SPDIF digital audio 
prototyping board! from HDMI 


e |1?C controlled ‘ 


Our Official % — ee ——— —_ 2 
Distributors adafruit =~) Stivice kilwi@electronics =~ SSKUBI] MODMYPI MIGOGK=Y § PrSucr.cn RG sparkfun.. 


Terminal — [en = (ey 


©©®©® pi@raspberrypk: ~ 

Lucy@lucy-MacBook:~$ ssh pi@i192.168.6.19 

The authenticity of host '192.168.6.19 (192.168.60.19)' can't be established. 
ECDSA key fingerprint is SHA256:k2RP2BuKYuu1UF79n1WTSSv+6ZGLF3mg3ryH4z0/0SE. 
Are you sure you want to continue connecting (yes/no)? yes 

Warning: Permanently added '192.168.6.19' (ECDSA) to the List of known hosts. 
pig@192.168.6.19's password: 


The programs included with the Debian GNU/Linux system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent 
permitted by applicable law. 

Last Login: Tue Dec 6 16:14:12 2016 from 192.168.6.38 

pi:~ § ls 
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Raspberry Pi Configuration - 


system | Interfaces Performance Localisation 
Camera Enabled ©) Disabled 
SSH *) Enabled Disabled 
INC Enabled *) Disabled 
SPI Enabled *) Disabled 
I2C Enabled *) Disabled 
Seria Enabled *) Disabled 

Wire Enabled *) Disabled 
Remote GPIO Enabled ©) Disabled 


§R 


Category: 
Session 
Logging 
Terminal 
Keyboard 


Features 

y Wind ri 
appearance 
Behaviour 
Translation 
Selection 
Colours 

Connection 
Data 
Proxy 
Telnet 
Rlagin 

+}- SSH 


Sénal 


About 


© © tucy@tucy-mMacBook: - 

lucy@lucy-MacBook:~$ ssh pig@i92.168.6.19 

The authenticity of host °192.168.0.19 (192.168.6.19)' can't be established. 
ECDSA key fingerprint ts SHA256:k2RP2BuKYuuluF 79m IWTESV+6ZGLF 3ng3ryH4z0/oSE. 
“Are you sure you want to continue connecting (yes/no)? ye 


Basic options for your PUTTY session 


Specify the destination you want to connect to 


Host Name for IP address) Port 
192.168.0.19 22 
Connection type 


C)Raw () Telnet C)Riogin @)SSH () Senal 


Load, save or delete a stored session 
Saved Sessions 


Default Settings Load 
Save 
Delete 


Close window on edt 


() Aways ()Never (@) Only on clean ext 


Open Cancel 
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Performance Localisation 


*) Enabled D 
*) Enabled D 
Enabled ° 
Enabled »D 
Enabled ~D 
Enabled »D 
Enabled »D 
Enabled ») D 


Sabled 
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MAKE A PUSH BUTTON 


MUSIC BOX 


Use two or more tactile push buttons to play different sound samples 


n this easy electronics project, we’ll use push of Scratch’s built-in percussion sounds, already 
buttons to make a GPIO music box that triggers present on the Pi. In your Terminal, enter mkdir 
different sounds when we press the buttons. samples, then change to that directory: cd samples. 
EINE ere Now copy the Scratch percussion sounds with: 
1x solderless > STE p- 01 
SSI ete Get some sounds cp /usr/share/scratch/Media/Sounds/ 
2x push buttons Open a Terminal window and create a new folder: Percussion/* . 
3x male-to- mkdir musicbox. Switch to it with cd musicbox. Now 
female jumper we need to source some sound samples. While there 
wites are many public domain sounds online, we’llusesome >S!IEP-O2 
2x male-to-male Play a drum 
ages mathe pecan eer ou A First, we’ll create a simple Python program to playa 
Headphones the connected to add) share a drum sample repeatedly. Open Python 3 (IDLE), create 
bao oul saan by lee ce eo . a new file, and enter the code from ch4listing1.py. 
default) Low ‘~ rail Save the file in your musicbox folder. Press F5 to run 
the program and listen to it play. If you can’t hear it, 
a al al a aS a you might need to alter your audio configuration; ina 


Terminal, enter amixer cset numid=3 1 to switch it 


: ween Likgie ged ane wa wa ca to the headphone socket, or amixer cset numid=3 1 
. eovryerrryerervereTTs to switch to the HDMI output. 

6 © >STEP-03 

Se 8 re ee Wire up a button 

a ere ag ean alec GR a 6 ESS See we Turn off the Pi to start building a circuit. Place a 


push button so it straddles the central groove of 
————— the breadboard. One leg is connected to GPIO pin 2, 
Se ar and the other to the common ground rail on the 
breadboard, which in turn is wired toa GND pin. 

We’ll make a sound play when the button is pressed. 
Open a new file in Python 3 IDLE, enter the code from 
ch4listing2.py, and save it in your musicbox folder. 
At the start, we import the Button class from GPIO 
Zero, and the pause class from the signal library. We 
assign the button variable to GPIO pin 2, with button 
= Button (2). We tell the sound to play when the 
button is pressed, using button.when_pressed = 
drum.play. Finally, we add pause() at the end so that 
the program will continue to wait for the button to be 
pressed. Run the program and every time you press 
the button, the drum sound should play. 


i 
= 
aa 
= 
= 
= 
= 
= 
= 
pet 
= 

cm 
= 
= 
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Below Each time you press a button, the assigned sound sample 
will play through a connected speaker 


>STEP-04 

Add a second button 

We’ ll now add a second button, as in the diagram. 
Wire it to GPIO 3 and the ground rail. Open a new file 
in Python 3 IDLE, enter the code from ch4listing3. py, 
and save it in musicbox. Note that rather than 
assigning the Button objects and sounds to the pins 
individually, we’re using a dictionary structure to 
assign their numbers to sound samples: 


sound pins = { 
2: Sound("samples/DrumBizz.wav"), 
3: Sound("samples/CymbalCrash.wav"), 


We then create a list of buttons on all the pin 
numbers in the sound_pins dictionary: buttons = 
[Button(pin) for pin in sound_pins] 

Finally, we create a for loop that looks up 
each button in the dictionary and plays the 
appropriate sound: 


for button in buttons: 
sound = sound_pins[button.pin.number | 
button.when_pressed = sound.play 


Run the program and press each button to hear a 
different sound. 


>STEP-05 

Add more buttons 

The way we have structured the program makes it 
easy to add extra buttons and assign them to sound 
samples. Just connect each button to a GPIO number 
pin (not any other type) and the ground rail, as before. 
Then add the GPIO pin numbers and sounds to the 
dictionary, as in the following example: 


raspberrypi.org/magpi 


MUSIC BOX 


ch‘tlisting! py 


import pygame.mixer 
from pygame.mixer import Sound 


pygame.mixer.init() 
drum = Sound("samples/DrumBuzz.wav" ) 


while True: 
drum.play() 


ch‘Histing2.py 


from gpiozero import Button 
import pygame.mixer 

from pygame.mixer import Sound 
from signal import pause 


pygame.mixer.init() 
bUECeh = "BUEOn( 2) 
drum = Sound("samples/DrumBuzz.wav" ) 


button.when_pressed = drum.play 
pause( ) 


ch‘tlisting3.py 


from gpiozero import Button 
import pygame.mixer 

from pygame.mixer import Sound 
from signal import pause 


pygame.mixer.init() 
sound pins = { 


2: Sound("samples/DrumBuzz.wav"), 
3: Sound("samples/CymbalCrash.wav"), 


>PYTHON 3 


DOWNLOAD: 
magpi.cc/2bhwqlH 


buttons = [Button(pin) for pin in sound pins] 


for button in buttons: 
sound = sound pins[button.pin.number ] 
button.when_pressed = sound.play 


pause() 


sound_pins = { 
2: Sound("samples/DrumBizz.wav" ), 
3: Sound("samples/CymbalCrash.wav"), 
4: Sound("samples/Gong.wav"), 
14: Sound("samples/HandClap.wav"), 
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Tutorial 


AN INTRODUCTION TO C 
ARRAYS AND STRINGS 


How to handle arrays (lists of values) and strings (lists of letters) in C 


KEEP INSIDE 
YOUR ARRAY 


One of the 
nastiest 
sources of 
crashes and 
bugs in C is 
creating an 
array and then 
writing past the 
end of it. The 
compiler won't 
stop you writing 
to memory 

off the end of 
an array, and 
doing so can 
have serious 
consequences. 
Always make 
sure your array 
indices fit inside 
your array. 


Below Array 
elements are 
stored sequentially 
in memory, with 
the array name 

a pointer to the 
first element. 
Multi-dimensional 
array elements 
are stored with 
the elements with 
neighbouring 
values in the 
rightmost index 
next to each other 


y 


b[O][0) 


b[0)[7] 


b[O}[2] 


he variables we’ve looked at so far are all 
single numeric values. In this instalment, 
we’re going to look at how C handles lists 
of values, and that leads into using lists of letters to 
store and manipulate text strings. 

An array is a variable which stores multiple values 
of the same type; the individual values are accessed 
by indexing the array. An array can have one or more 
dimensions; a one-dimensional array is a single list of 
values, while a two-dimensional array is a list of lists 
of values, and so on. 

An array is declared in C by putting the size of each 


dimension in square brackets after the variable name. 


SO: 

int a[10]; 

is a list of 10 integers, while 
int b[5][6]; 


is a list of five lists, each containing six integers. 
When accessing the elements inside an array, the 
array index — the number inside the brackets — starts 
at 0. So the integers contained within a above are 
referred to as a[@], a[1], a[2] and so on, up to a[9]. 


Arrays and pointers 

The name of an array is effectively a pointer to the 
first element of the array. An array is a contiguous 
block of memory which contains all the elements 
in order, SO you can use a pointer to access it. 


al7] als] a9) 


bOI) 


] 


b[O}[5] bii}[2] bf 1][3] 


b[1}[0] | b[1)[1] 


b[O][3] 
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Here’s an example: 


#include <stdio.h> 
void main (void) 
{ 
int a[10]; 
int count; 
for (count = 0; count < 10; count++) 


{ 


a[count] = count * 10 + count; 
} 
printf ("The first and second elements 
of a are %d and %d\n", a[@], a[1]); 
printf ("Or, as pointers, %d and %d\n", 
*a, *(at1)); 


} 


This fills the ten values of a with the numbers 
O, 11, ... and then reads a[@] and a[1]. It then reads 
the same values using a as a pointer; running the code 
shows that they are identical. 

With a multi-dimensional array, you need to 
consider how the compiler arranges the dimensions in 
memory. The elements at the rightmost index of the 
array are grouped together. With the array b[5][6], 

b itself points at b[@][@]. b+1 points at b[@][1], b+5 
points at b[@][5], and b+6 points at b[1][@]. 

You can initialise an array at the same time as you 

declare it by putting the values in curly brackets: 


int a[10] = { @, 11, 22, 33, 44, 55, 66, 77, 88, 99 }; 


This only works when the array is first declared; once 
it exists, you can’t use this shortcut and will need to 
iterate through the array, setting each value in turn. 


Strings 

In C, a string is an array of single characters. 

A character is a specific type in C, called char - this 
holds a single byte, storing an ASCII character. 

A string with ten bytes would be: 


char mystring[10]; 
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Or, to initialise it at the same time: 
char mystring[10] = "thestring"; 


A string in C must end with a byte set to zero, and 
the memory required to hold this final zero (called the 
string terminator) must be allocated when you declare 
the string. So mystring, declared as an array of ten 
chars, can only hold nine or fewer letters.. 

You can use the index in square brackets to access 


13 printf (*The first and second elements of a are 
14 printf (*Or, as pointers, “Sd and “d\n*, *a, *(atel)); 


number of elements 


a qd - 


wd and So\n", alo), afi)}); File Edit Tabs ; =i¢ 


mystring 


Symbols |? tii il _ An array can be accessed 
aie Pincludge <stdio.h> p a . i c 
@ Functions > ayy by its indices inside square 
GP main [3] : void main (void) brackets, or as a pointer 
© int afi0); 
6 int count; 
7 
8 for (count = 0; count < 10; count++) 
9 
10 alcount]) = count * 10 + count; 


3 


Above Strings are stored as an array of single characters, 

with the element after the last character set to zero 

and dst at the start of the empty str3. We loop, 
copying from src to dst and incrementing both 
pointers, until we find the zero that terminates 


KEEP INSIDE 
YOUR STRING 


As with arrays, 
it's even easier 


individual characters in a string, or you can use a stri. We then point src at str2, and do the same aa es 
pointer. Here’s an example using pointers to join thing again until we find the zero at the end of and to corrupt 
two strings together: str2. Finally, we write a zero to the end of str3 memory 
to terminate it. Be SUELO 
; : . a result. If in 
#include <stdio.h> Note the format specifier used to print strings - doubt, declare 
void main (void) #S is used to print a string, and will display every your string ~ 
{ character from the pointer supplied as an argument Nehaaeen te 
char stri[10] = "first"; up to the first terminating zero. (To print a single than you think 
char str2[10] = "second"; character, you can use the format specifier %c. ) you'll need, 
d make sure 
char str3[20]; a 
eae . that what you 
char *src, *dst; Writing to strings aye Gating 
SRGe=aSbR ly Because the name of a string variable is only a pointer into them 
dst = str3; to the first character of the string, you can’t use SOE TUL: 
while (*src != @) an equals sign to set the value of a string. You can 
{ initialise a string variable at the time you declare NAMES ARE 
*dst = *src; it, as above, but to set it later, the easiest way is the POINTERS 
SrCtt; sprintf function. This is like printf; the difference Maite 
dst++; is that the first argument it takes is the name of a cleyae - 
} string variable, and it writes to that instead of to the array or a string 
Shera isth2, command line: Is Just a pointer 
hile (# = @ to the first 
while (*src != @) element of the 
{ #include <stdio.h> array or string 
*dst = *src; void main (void) in question, and 
; can be used 
aoa { in the same 
dst++; int val = 12; way as any 
} char string[5@]; other pointer, 
Seer y it can be 
St = YU; incremented 
printf ("%s + %s = %s\n", stri, str2, str3); sprintf (string, "The value of val is %d\n", val); and 
} printf ("%s", string); decremented, 
or 
} dereferenced 


We initialise two strings, str1 and str2, and 
we allocate an empty string, str3. We create a pair 
of char pointers, and point src at the start of str1 
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The sprintf function adds the terminating zero 
at the end of any String it creates. 


to find the 
value to which 
it points. 
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Tutorial 


) 1+ Raspberry Rake 


{) 3- Not Quite Pi 
SS : Tid io pe | Ti ia pe 
1 = “|, tres, 1 
— on =a =e 

i 1 1 1 
Ps 


es 


Shows the two points 
the ball must visit to 
advance your horse 


Tilt the box to guide 
the ball between 
the contacts 


> 2x 16mm 
ball bearings 


> 8x 15mm M3 
hex pillars 


> Five-way ribbon 
cable 


> Perspex and 


perme § \\Vill ‘Raspberry Rake’ or ‘Not Quite Pi’ be the first to the winning line: 


> 5mm by 17mm 


strip pine e remember the ‘roll a ball’ horse race game 
and glue from amusement parks with great fondness, 

> 16x M3 solder so this month we thought we would create a 
tag washers two-player race game inspired by it. In the original 

> 16x M3 nuts you had to roll balls up a ramp into a hole and, 

“ale: Paaliend) depending on what hole the ball dropped into, your 
10mm, M3 horse advanced a certain distance. You could have up 


machine screws 


to 20 wooden horses racing each other, with a prize 
for the winner. When the game was reset, all the 
horses moved backwards to the starting line again. 


THEPIDERBY Yutorial 


PLAYER 02 PLAYER 02 


GPIO 22 GPIO 17 
GPIO 10 GPIO 24 
Gnd Gnd 
GPIO 11 GPIO 27 
GPIO 9 GPIO 4 
Fig 1 
Our game 


As the original attraction was very big, things had to BUILDING THE GAME BOXES 


be scaled down drastically to fit in the Bakery. First off, 
the number of players has been reduced to just two, 
and the wooden horses have been transferred to on- 
screen graphics. Finally, in order to reduce the size even 
further, the skill element has been miniaturised as a 
small ball bearing puzzle. Each time the ball bearing 
is manoeuvred between two requested positions, your 
horse advances, and the first to the finishing line 
wins. Unlike other race games we’ve made in 

the Pi Bakery, this one isn’t against the clock but 
another opponent. The increasing excitement and 
pressure of the race makes precise control of the ball 
bearing increasingly difficult, and that’s not allowing 
for unsportsmanlike nudges from the other player. 


The interface 
The game interface is simple enough. There are four 
pairs of nuts in the playing box and as the ball bearing 
is brought to rest against a pair of them, it completes ) 1 
a circuit and grounds a pulled-up GPIO pin. This is 3 x. : ai yee he 
then read by the Raspberry Pi and if it’s the position » .. gw 
you’ve been asked to reach, your horse advances. The : ‘ 
wiring diagram is shown in Fig 1; as this is a two- 
player game, you will need to make two of them. We 


avoided the pins GPIO 2 and 3 as there’s a strong pull >STEP-O1 

up wired to these, so they needed better contact with Gathering the materials 

the ball to register a touch than the other pins. The The two boxes are 100mm by 90mm, and you need to cut this from 6mm 
alignment of the contact nuts was made so that it was plywood. Also, cut an identical size of acrylic sheet for the cover. Clamp the 
more difficult to go from one position to the other, two together when drilling the pillar holes to make sure they line up. Then 


thus requiring more skill. The construction details are cut eight lengths of 5mm by 17mm strip pine, g9omm Long, for the sides. 
shown in the step-by-step guide. 
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Tutorial 


The resources 

The graphics for the horses were taken from a cut- 
out supplement, printed in the Boston Sunday Globe 
in September 1905, by RF Ayers; this is now well out 
of copyright. This cut-out featured two horses in 
mid-gallop, curiously carrying the numbers ‘one’ 
and ‘three’ on the saddle cloth. We have named the 
first horse ‘Raspberry Rake’ and the third ‘Not Quite 
Pi’, which we thought were suitable racing names. 
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These horses were cut out electronically in a graphics 
package, and the background made transparent. 

Then they were reduced to just 196 by 136 pixels. The 
eraphic of a track was drawn with a finishing post and 
line, and then a front rail was drawn with transparent 
sections between the rails. Finally, a sequence of 
eraphics was drawn to indicate the required path of 
the ball bearing for each challenge. We also gathered 
a series of sound effects from the internet to help the 
game along. 


Playing the game 
The graphic by the horse name shows the two points 
the ball bearing must visit to advance the horse. The 
filled orange circle indicates the current target for 
your ball: only when you visit the start position, and 
then the end one, will the horse move. When you 
have just visited the start position, there will bea 
horse whinnying sound, and then you get the horse 
galloping sound and animation when you visit the 
last position. When the horse advances, not only 
does it go forward, but it also moves slightly up and 
down in a galloping motion; this mimics the original 
fairground version. When one of the horses crosses 
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1 - Raspberry Rake © 3- Not Quite Pi 


4 te go 224 19 go 


Above Move the ball bearing as shown to advance your horse 


the finishing line, the winning margin is calculated 
and printed using the correct horse racing terms: a 
head, short head, length, and so on. Then the horses 
are wound back to the start with an accompanying 
ratchet sound just like the original, and the race can 
Start again. At any time, pressing the RETURN key 
will restart the race. We found occasionally that a 
ball would sit on the contacts but still not make an 
electrical connection. In that case, a small vibration 
of the box soon made a good connection. 


The software 

The derby.py code listing is shown overleaf; this and 
the accompanying graphics are on our GitHub page 
(magpi.cc/1NgJjmV). Like a lot of our projects, it’s 
written with the Pygame framework, and follows a 
pattern familiar to regular readers. The showPicture 
function first draws the track, then the two horses, 
and then the front rails; the last bit is the horse’s 
name and the distance to the finishing line, along 
with the current state of where the ball should go. 
You’ ll notice that the variables describing some 
positions have two or three simple additions, rather 
than a single number. This makes it a lot easier to 
spot where the individual offsets are applied when 
developing the code, but you could pre-add them if it 
worries you. The movePhase variable list shows if the 
current target for the ball is at the start or the end of 
the line. The horse is checked at each movement to 
see if it has crossed the winning line, and there’s also 
provision for the unlikely event of a dead heat. 


Taking it further 

You can modify the amount of movement a horse 
makes each time, thus requiring more or fewer ball 
movements per game. The game could easily be 
extended to more players; with each player needing 
four GPIO ports, there are ample resources for six 
players without resorting to any extra electronics. 
You could replace the single horse graphic with a 
number of frames to make smoother, more realistic 
movement like we did in the Olympic Swimming game 
(The MagPi #48); however, the original idea was to 
reproduce the mechanical fairground attraction. 


30mm 


100mm zen 


>STEP-03 

Drill the base 

The diagram shows the view into the tray; you might be better off 
marking the back and drilling from that side. Wire up the nuts and bolts 
to the Raspberry Pi's GPIO lines, using the solder tag washers, and test 
the connections are correct before fitting the acrylic cover. We useda 
small piece of double-sided sticky foam to fix the ribbon cable to the 
back of the box. 


>STEP-04 
Finishing off 
Make sure to clean off the ball bearings with some solvent, as finger 
grease can result in the ball failing to make a good contact. You can 
paint around the nuts with Bare Conductive paint to make a more 
reliable contact if you wish, but allow at least a day for this to dry. 


Tutorial WALKTHROUGH 


derb (oy dInc[n]| -=1 
py 62; gallop[n] = gallopAdv(gallop,n) 


G22 showPicture(distance, gallop) 
Q@1. # Pi Derby - Horse race game 64. if checkForFinish(distance): 
Q@2. # By Mike Cook - November 2016 65. restart = True 
@3. 66. time.sleep(4.0@) 
Q@4. import pygame, time, os, random 67. 
Q@5. import wiringpi2 as io 68. def moveDetect(dis): 
Q6. 69. global dInc, puzzle, moveTarget 
Q7. pygame.init() # initialise graphics interface 70. move = -1 
Q8. pygame.mixer.quit() ily for n in range(Q,2): 
Q9. pygame.mixer.init(frequency=22050, size=-16, 725 move = checkInput(n) # look at ball switch 
channels=2, buffer=512) vice if move != -1: 
10. UES # check if it is a valid move 
11. os.environ[ 'SDL_VIDEO_WINDOW_POS'] = ‘center’ 75. if move == moveTarget[n] : 
12. pygame.display.set_caption("The Raspberry Pi Derby") qe. if movePhase[n] == 1 : # move complete 
13. pygame.event.set_allowed(None) TT dInc[n] = 50 # move this * 3 
14. pygame.event.set_allowed([pygame.KEYDOWN, pygame.QUIT]) 78. gameSound[1].play() 
15. screen = pygame.display.set_mode([942,466],0,32) 79. last = moveTarget[n] 
16. textHeight = 36 ; textHeight2 = 24 80. puzzle[n] = random.randint(@,11) 
17. font = pygame.font.Font(None, textHeight) 81. while last == moveState[puzzle[n]][®] : 
18. font2 = pygame.font.Font(None, textHeight2) 22. puzzle[n] = random.randint(Q,11) 
dele 83. moveTarget[n] = moveState[puzzle[n]][0] 
2@. random.seed() ; winningPost = 704 Q4. movePhase[n] = @ 
21. ballPins = [ [17,24,4,27],[22,10,9,11 || | 85. else: 
22. targetGx = [ 18,102,18,102 |] 86. moveTarget[n] = moveState[puzzle[n]][1] 
23. targetGy = [ 18,18,102,102 |] a7. movePhase[n] = 1 
24. gallopInc = [1,1] ; gallop= [0,0] 88. showPicture(dis,gallop) # update move graphic 
25. diInc = [0,0] # distance increment 39, ifn == 
26. puzzle = [5,5] ; restart = True 90. gameSound[4].play() 
27. moveTarget = [1,1] ; movePhase = [0,0] Oa, else: 
28: 92. gameSound[5].play() 
29. def main(): os. 
30. global restart,dInc, gallop, puzzle,moveTarget,movePhase 94. def gallopAdv(gallop,n): 
Buby initGraphics() 95. global gallopInc 
32), initGPIO() 96. gallop[n] += gallopInc[n] 
32. #print "The Pi Derby" 97. if gallop[n] > 6 or gallop[n] <@: 
34. distance = [-120, -120] 98. gallopInc[n] = -gallopInc[n] 
aby showPicture(distance, gallop) 99. return gallop[n] 
SieyF while True: 100. 
a7. checkForEvent( ) 101. def checkForFinish(d): 
38. df Restamy 102. if d[@] >=winningPost or d[1] >=winningPost: 
39. gameSound[3].play() 103. gameSound[2].play() 
4Q. windBack(distance) 104. finish(d[@] - d[1]) 
41. pygame.mixer. fadeout (1000) 1s time.sleep(3.) 
AZ. time.sleep(3.5) 106. return True 
43. distance[@]| = -120 ; distance[1] = -120 107. else : 
44. gallop[@] = @ ; gallop[1] = @ 108. return False 
45. gallopInc[@] = 1 ; gallopInc[1] = 1 109. 
46. dincie]) = 3 dinel1] =¢ 110. def windBack(d): 
47. puzzle = [5,5] 111. wind =4 
48. moveTarget = [1,1] ; movePhase = [0,0] 112. while d[@] >= -120 or d[1] >= -120: 
49. gameSound[@].play() 113. showPicture(d, gallop) 
50. showPicture(distance, gallop) dias checkForEvent( ) 
Bl time.sleep(5) 115. for n in range(Q,2): 
Sue restart = False # show Puzzle 116. if d[n] >=-120: 
Bie)" showPicture(distance, gallop) 117. d[n] -= wind 
54. Lis; 
spol moveDetect (distance) 119. def checkInput(player): 
5G. if ding) 0) or dine(l| 120. ball = -1 
Sy for n in range(Q,2): 121. for pin in range(Q,4): 
58. if dInc[n] : ‘pee if io.digitalRead(ballPins[player][pin]) == @ : 
53) distance[n] += 3 ioe ball = pin 
6Q. if dInc[n] : 124. return ball 
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125: ST. else : 
126. def initGPIO(): 188. return "a nose" 
1277 trey 189. >PYTHON 2 
128. io.wiringPiSetupGpio( ) 198. def drawWords(words,x,y,f) : 
129. except : 191. i; tO. DOWNLOAD: 
130. print"start IDLE with ‘gksudo idle' from command line" ioZ. th = textHeight oe 
131, os._exit(1) 193, else : 
132. for player in range(@,2): 194. th = textHeight2 PROJECT 
133. for pin in range (0,4): 195. textSurface = pygame.Surface( VIDEOS 
134. i0.pinMode(ballPins[player][pin],®) (14, th) ) Cractou Miles 
Be # input enable pull up 9G: textRect = textSurface.get_rect() Bakery videos at: 
136. io.pullUpDnControl(ballPins[player][pin], 2) 1S77 textRect.left = x magpi.cc/1NqJnTz 
137. 198. textRect.top = y 
138. def showPicture(run, gal): pygame.draw.rect(screen, ( 
139% screen.blit(background, [@,0]) 199. 102,204,255) (Gy, 4 th=10) 5 @) 
140. screen.blit(horse1, [run[@],30+gal[@] ] ) 200. if f==0 ; 
141. screen.blit(horse3,[run[1],120+gal[1] ] ) textSurface = font.render(words, True, (@,0,0), (102,204,255)) 
142. screen.blit(foreground, [@,200]) 2O1r else : 
alley pygame.draw.rect(screen, (102,204,255), (0@,340,942,136), Q) 202. textSurface = font2.render( 
144. if not restart : words, True, (0@,0,0), (102,204,255)) 
145. screen.blit(move[puzzle[@]],[50,345]) 203. screen.blit(textSurface, textRect) 
146. pygame.draw.circle(screen, (255,154,51), ( 204. 
targetGx[moveTarget[@] ]+50, targetGy[moveTarget[@] ]+345) ,8,@) 205. def initGraphics(): 
147. screen.blit(move[puzzle[1]],[471+50, 345]) 206. global background, foreground, horse1, horse3,move,moveState, 
148. pygame.draw.circle(screen, (255,154,51), ( gameSound 
targetGx[moveTarget[1] ]+50+471, targetGy[moveTarget[1]]+345),8,0) 207. soundEffects = ["start","gallop","end", "ratchet", "horse1", 
149. drawWords("1 - Raspberry Rake",120+70, 350,0) "horse2" | 
15@.  drawWords("3 - Not Quite Pi",120+471+70, 350,0) 208. background = pygame.image.load( 
151.  drawWords(str(winningPost-run[@])+" to go",120+70,400,1) "images/track.png").convert_alpha() 
152.  drawWords(str(winningPost-run[1])+" to go",120+70+471,400,1) 209. foreground = pygame.image.load( 
153. pygame.display.update() "images/rail.png").convert_alpha() 
154 210. horsel = pygame.image.load("images/rr.png").convert_alpha() 
155. def finish(distance): 2 lee horse3 = pygame.image.load("images/np.png").convert_alpha() 
156. if distance != @: 212. move = [ pygame. image. load( 
cloye caption = “Wins by “ + margin(abs(distance) ) “images/dir"+str(m)+".png").convert_alpha() for m in range(@,12) ] 
dboyets if distance < @: 213% movestace =| [0,3)5 3505 (2, 815115 21510,21. 12,015 (6521 125315 
159. x= 120+70+471 Eee Ane ea) 
160. else: 214. gameSound = [ pygame.mixer.Sound( 
alsa X= 120+70 “sounds/"+soundEffects[sound]+".wav") for sound in range(@,6) ] 
162: drawWords (caption, x, 400, 1) 215), 
16a: else : 216. def terminate(): # close down the program 
164. drawWords("Dead heat" ,120+70, 40,1) 2A print "Closing down please wait" 
165. drawWords("Dead heat", 120+70+471,400,1) 218. pygame.mixer.quit() 
166.  pygame.display.update() 219, pygame.quit() # close pygame 
167. 220. os. exit(1) 
168. 228 
169. def margin(dist): 222. def checkForEvent(): # see if we need to quit 
170. separation = dist / 120.0 223%. global restart 
ale, if separation >1.8: 224. event = pygame.event.poll() 
72s return "a distance" 225. if event.type == pygame.QUIT : 
1732 elif separation >@.9: 226; terminate() 
174. return "a length" 227 if event.type == pygame.KEYDOWN : 
175% elif separation >@.7: 2287, if event.key == pygame.K_ESCAPE : 
7G. return "three quarters of a length" 229°, terminate() 
sb7 elif separation >@.4: 250); if event.key == pygame.K_RETURN : 
178. return "half a length" restart = True 


73s elif separation >@.25: 

180. return "a neck" 233. # Main program logic: 
131. elif separation >0.2: 

27 return “a short neck" 

1837 elif separation >@.1: 

184. return "a head" 


135. elif separation >0.@5: 
return "a short head" 
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BOING Manager 


File View Todls Actiwity Advanced Help 


ElNotices | @Projects | MTasks @ Transfers be Statistics Disk 


= TOC BGO Unit |earmn WORK Cone Avd. work Hesource s Status 


Losmology@Home p 0.00 TOO(50.0... Communication deferred 


Asterondismnone MagPi 0.00 HOO (60.0 


Keep an eye on how much 
power your tasks are using 


Donate power to scientific 
projects using your 
Raspberry Pi 


Home page 
Your account 
Discussion fonum 
Scientiic results 


Donate to Astero 


© Connected to localhost (7.4.23) 


POWER WITH B Ol N 


Got a Raspberry Pi that idles away most of its day? 
Lend some of its CPU power to science 


emember screen savers? It occurred to us the SETI, the organisation that looks for extraterrestrial 
BOINC other day that they’ve gone almost totally out life. With this screen saver, you’d also be lending some 
boinc. of fashion, with turning your screen off being of your computer power to help them out. 
berkeley.ecit the preferred (and probably greener) solution to burn- The technology still exists with BOINC and is 
A Raspberry Pi in. One of the more popular screen savers of the time used in many more applications these days, such as 
MAE GIG UE: was a little display that showed number crunching from protein folding and anything else that requires lots of 
An internet processing power. We recently had a reader write in 
ceailalnadels eel li Tabatdal about using the idling CPU power of a Pi with it, so we 
Anta _ decided to put together a little tutorial to let people 
fa AR kT se ob aes “share some Pi goodness with the science world. 
@ processor usage | @networkusage Odisk and memory usage Jéexclusive applications 
sheen ee >STEP-01 
4 © whilecomputeris in use Choosing a Pi 
mo aI A ae ear ets — * Not just any Raspberry Pi is suitable for running 
“OE ROO en ARE eT *  BOINC. If you’re making projects and using your 
by | ENE pees ET prey OIA Pb: nD Pi as anormal computer, you’re likely not going 
|| Day-of-week overide | = to have it idling often. The kind of Pi that works 
Mm) © Monday Tuesday best for BOINC is something that’s on all the time, 
Wednesday Thursday or at least for a long time each day: file servers, 
a ——o home automation, Christmas tree lights, and so 
oe on. These have a lot of processing power to spare, 
Sake busi applications every 60.00! minutes more than enough to lend some to another project 
Right Change the On multiprocessor systems, use atmost| 0.00 % of the processors (0 means no restnction using BOINC. 
settings to make Use st most 100.00) % 6 CHU tine (0 manne no sestacton) Remember, though: this does mean it will use up a 
oie FOU eo little more electricity while performing BOINC tasks, 
as best as it can ‘ rete ae 
with BOINC = eee ees so keep that in mind. 
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>STEP-02 
Installing BOINC 
BOINC is included as one of the packages available for 


Raspbian, so installing it is pretty easy. First, you need 


to perform the customary update to the Raspberry Pi 
by opening a Terminal and entering: 


sudo apt-get update 
sudo apt-get upgrade 


Once that’s complete, you can then install BOINC 
from the command line. Do this with: 


sudo apt-get install boinc 


This will install BOINC and the graphical BOINC 
Manager tool for easily accessing and controlling how 
you use BOINC. It even shows stats for your projects. 


>STEP-03 

Open BOINC 

BOINC works in both the command line and on the 

eraphical desktop. It’s a bit more involved to get 

it working in the command line, but if that’s your 

preferred method, we suggest taking a look at this 

ereat tutorial on how to do so: magpi.cc/2hgkTYO. 
For this tutorial, we’re going to be working in the 

desktop environment. Go to the top-left menu in 

Raspbian; under System Tools you’|l find the BOINC 

Manager. Open it up, and we can start choosing and 

adding projects to the system. 


>STEP-04 

Choose qa project 

Choose ‘Add project’ on the screen and then go to 
Next. If you already have a BAM! or GridRepublic 
account, you can also add it here instead. You’ll then 
be presented with a list of projects you can join, such 
as the aforementioned SETI. They’ ll usually give 


details on what they’re studying and how you can help 


them, but you might need to do some extra online 
research as well. 


Above The advanced view gives you more options 
for keeping an eye on your projects 
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BOINC 


© OG FG marin 


BOING Manage 


Click your choice and then press Next. From here 
you need to create an account (or log in if you already 
have one), and the project will be ready to start. 


>STEP-05 

Configure BOINC 

The default settings for BOINC are fine, but you 
might want to do a bit of tweaking anyway, especially 
to change what it considers as idle on your system. 
From the View menu, select Advanced View to access 
all the options. Here you can change not only the 
processor usage, but also set limits on network and 
disk/memory usage. You can even drill down a bit 
further into what tasks BOINC is running, how many 
resources it’s using, and further stats. 


>STEP-06 

Run BOINC 

All you need to do now is leave your Raspberry Pi and 
BOINC running. It will automatically take tasks from 


the project you signed up to and do some crunching on 


them. It may take a little while longer on the Pi than 
some other computers, but you’1l be doing your bit 
for science nonetheless. After reboots, you may need 
to double-check it’s running, and it’s best to check 
Pis that are on 24/7 every now and then to make sure 
they’re doing the job properly as well. 


- 


puiraspberrypi: = 


Above The installation on the command Line is quick 
and pretty easy — you'll have it in no time 


Tutorial 


Above Choose one 
or more of multiple 
projects that will 
help scientists 


ENERGY 
USAGE 


As mentioned, 
you'll use 

up more 
electricity 
using BOINC. 
Change the 
settings to 
tweak how 
much it uses. 


SENSITIVITY 


Worried your 
Pi will want to 
do something 
and not have 


the power? 
Tweak how it 
defines idle 
to make sure 
the Pi gets 
power when it 
needis it. 
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Tutorial 


Strange critters 
roam the Earth on 


WALKTHROUGH 
» JOHANNES BERGS 


Johannes Bergs wants to know 
more and likes the realm of 
humans and machines. 
knight-of-pi.org 


a chilly winter day 
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GOOGLE 
ON THE 


Do computers dream of electric sheep? Find out by making your 
Raspberry Pi dream with the amazing Google DeepDream algorithm 


> Camera Module 
magpi.cc/ 
28ljlsz 


> PsyCam 
magpi.cc/ 
2eCSQOD 


RASPBERRY PI 2 
COMPATIBILITY 


reams can be beautiful, surreal, or even 

scary. While we can assume that they playa 

role in learning, their exact purpose remains 
unknown. What would a computer see if it could 
dream? You can find out by installing the amazing 
Google DeepDream software on your Raspberry Pi! 

DeepDream is derived from a neural network 
for object recognition, which has been modified 
to express every object it vaguely recognises. The 
resulting images are impressively surrealistic, 
bearing more than a passing resemblance to the 
paintings of artists like Salvador Dali. 

Neural networks are a very versatile technology. 
They can be applied to a variety of complex problems 
like facial recognition, text translation, or even 
playing games like Go. 

Caffe, the neural network upon which Google built 
DeepDream, was originally developed for identifying 
objects in images. To achieve this, the network is 
trained on a large set of images to identify the main 
features of the objects presented. 
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Artificial neurons 

Artificial neurons mimic their natural counterparts, 
the neurons in the human brain. Every artificial 
neuron has an activation threshold and numerous 
weighted incoming and outgoing connections to other 
neurons. If the sum of the weighted signals from 

the incoming connections exceeds the activation 
threshold, the neuron fires a signal. 


Neural networks 

Generally, neural networks consist of at least three 
layers of neurons. The input layer reads the input, one 
or more hidden layers process the information, and 
the output layer shows the result. 

Consider a neural network for recognising the 
numbers zero to nine in images with a size of 28x28 
pixels. The input layer would have 784 neurons, one 
for every pixel. If an image is presented to the input 
layer, every neuron in it produces a signal witha 
strength corresponding to the greyscale value of its 
pixel, with a darker pixel generating a stronger signal. 
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Every input neuron is connected to all neurons of 
the first hidden layer, but every connection has a 
distinct weight. The higher the weight, the more of 
the input neuron’s signal reaches the hidden neuron. 
If the total signal strength arriving at a hidden neuron 
tops its activation threshold, the hidden neuron fires 
a signal to all neurons of the next layer which, in 
this simplified example, is the output layer. Again, 
the signal intensity depends on the weight of the 
connection and the incoming signal strength. 

The output layer has one neuron for every object to 
be classified, so ten neurons are used to identify the 
numbers from zero to nine. If the activation threshold 
of an output neuron is surpassed by the weighted 
incoming connections, the resulting signal strength is 
a measure of confidence in the classification. 


Machine learning 
The weights and thresholds are initialised randomly, 
which can cause very bad classification results. 

If an output neuron is activated incorrectly (e.g. 
if an image from the training set shows a five, but 
the output neuron for two produces a strong signal), 
its activation threshold and all the weights of its 
incoming connections are adjusted. Then, the error is 
propagated back proportionally through all connected 
neurons lower in the chain, from the highest hidden 
layer down to the input layer. This process is repeated 
for all of the images in the training data set until the 
results given by the network begin to improve. 

Instead of accurately detecting objects in images, 
by contrast, DeepDream actually changes the input 
image to make it more similar to the objects learned 
from the training data. 

Imagine a cloud as an input image. Some structure 
in the cloud might have a vague similarity to the 
features DeepDream associates with a ‘dog-like’ 
object. If this is the case, the input image is changed 
to look more dog-like. 

Additionally, DeepDream allows for selection of the 
hidden layer depth. Since a layer has more detail the 
closer it is to the output level, output images can range 
from basic shapes to detailed dream-like creatures. 
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DEEPDREAMS 


Have some DeepDreams 
Insert an SD card with Raspbian Jessie installed into 
the Raspberry Pi, attach the Camera Module and 


peripherals, then boot it up. To install the DeepDream UUs 
magpi.cc/2eCSQOD 


software, enter the following in a Terminal: 


mkdir ~/deepdream && cd ~/deepdream 

git clone https://github.com/JoBergs/PsyCam 
cd PsyCam 

python install_tools.py packages 

python install _tools.py caffe 

python install _tools.py protobuf 

python install_tools.py camera 

sudo reboot 


After downloading the project from GitHub, use 
the custom installer to first install all packages with 
pip or apt-get. Then, install the open-source neural 
network framework Caffe. Because speed matters, you 
should also install the serial data processor protobuf 
from Google. Finally, activate the camera and reboot. 

All in all, the installation takes a few hours, so 
you’ ll need to be patient! The installer should also 
work for any newish Ubuntu operating system. If you 
encounter problems, try using the manual installation 
instructions at magpi.cc/2eCSxDt. 

Enter the following, and your Pi can start to dream: 


cd ~/deepdream/PsyCam 
python psycam.py 


The network parameters depth (-d), octave (-o), 
and type (-t) are randomized. Adda -c to dream 
continuously. Pass -i IMAGE. jpg to use an image 
as the base for the dream instead of a snapshot. Find 
more information on input arguments by checking the 
command-line help: 


python psycam.py -help 


When the Pi finishes dreaming, the dream and the 
original photo are stored in the directory /home/pi/ 
deepdream/PsyCam/dreams with a timestamp. You 
can watch them by opening the directory in the file 
browser and double-clicking the image. 


>PYTHON 


ORIGINAL 


Tutorial 
qanguage 


DEEPDREAM 


ARTICLE 


Have a look at 
the amazing 
original 
article about 
DeepDream 
by Alexander 
Mordvintsev, 
Christopher 
Olah, and Mike 
Tyka here: 
magpi.cc/ 
2eCRHH3 


NEURAL 
NETWORK 
TUTORIAL 


If you want to 
learn more 
about neural 
networks, 
why not 
check out this 
interesting and 
well-written 
introduction 
by Michael 
Nielsen?: 
magpi.cc/ 
2eCUO1u 


KIVY GUI 


Try the 
powerful 
Python GUI 
framework 
Kivy for 
building a 
GUI: it is slick 
enough to 
embrace 
DeepDream. 


Alice in a very colourful wonderland 
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Tutorial 


))) Sonic Pi 


SAMPLE 
STRETCHING 


Sam Aaron shows how to do more with samples 


Raspberry Pi 
aUlalaliavemacctsjele)iclal 


Sonic Pi v2.9+ 


Speakers or 
headphones with 
a 3.5mm jack 


Update Sonic Pi: 
sudo apt-get 
update && sudo 
apt-get install 
sonic-pi 


hen people discover Sonic Pi, one of the 

first things they learn is how simple it is to 
play pre-recorded sounds using the sample 
function. For example, you can play an industrial 
drum loop, hear the sound of a choir, or even listen to 
a vinyl scratch, all via a single line of code. However, 
many people don’t realise that you can actually vary 
the speed at which the sample is played back for some 
powerful effects and a whole new level of control of 
your recorded sounds. So, fire up a copy of Sonic Pi and 
let’s get started stretching some samples! 


Slowing samples down 
To modify the playback rate of a sample, we need to 
use the rate: opt: 


sample :guit_em9, rate: 1 


If we specify arate: of 1, then the sample is played 
back at the normal rate. If we want to play it back at 
half speed, we simply use a rate: of @.5: 


Sample :guit_em9, rate: @.5 


Notice that this has two effects on the audio. Firstly, 
the sample sounds lower in pitch; secondly, it takes 
twice as long to play back (see the boxout on the next 
page for an explanation of why this is the case). We 
can even choose lower rates moving towards ®, soa 
rate: of @.25 is a quarter speed, @.1 is a tenth of the 
speed, and so on. Try playing with some low rates and 
see if you can turn the sound into a low rumble. 


Speeding samples up 

In addition to making the sound longer and lower 
using a small rate, we can use higher rates to make 
the sound shorter and higher. Let’s play with a drum 
loop this time. First, listen to how it sounds at the 
default rate of 1: 


sample :loop_amen, rate: 1 
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Now, let’s speed it up a little: 
sample :loop_amen, rate: 1.5 


And we just moved musical genres from old-skool 
techno to jungle! Notice how the pitch of each drum 
hit is higher, as well as the whole rhythm speeding up. 
Now, try even higher rates and see how high and short 
you can make the drum loop. For example, if you use a 
rate of 100, the drum loop turns into a click! 


Reverse gedr 

I’m sure many of you are thinking the same thing right 
now: “What if you use a negative number for the rate°”’. 
Let’s think about this fora moment. If our rate: opt 
signifies the speed at which the sample is played back, 
with 1 being normal speed, 2 being double speed, and 
@.5 being half speed, -1 must mean backwards! Let’s try 
itona snare. First, play it back at the normal rate: 


sample :elec filt_snare, rate: 1 
Now, play it backwards: 
sample :elec filt_snare, rate: -1 


Of course, you can play it backwards twice as fast 
with a rate of -2, or backwards at half speed with a 
rate of -@.5. Now, play around with different negative 
rates and have fun. It’s particularly amusing with the 
:misc_burp sample! 


Pitch bending 


As we’ve seen, using a faster rate will make the sound 
higher in pitch, and a slower rate will make the sound 
lower in pitch. A very simple and useful trick is to 
know that doubling the rate actually results in the 
pitch being an octave higher; inversely, halving the 
rate results in the pitch being an octave lower. This 
means that for melodic samples, playing it alongside 
itself at double/half rates actually sounds rather nice: 
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FIVE LIVE-CODING TECHNIQUES | Tutorial 


SAMPLE, RATE, AND PITCH 


One of the effects of rate modification on samples is that faster 
rates result in the sample sounding higher in pitch, and slower 
rates result in the sample sounding lower in pitch. Another place 


you may have heard this effect in everyday life is when you're 


cycling or driving past a beeping pedestrian crossing. As you're 
heading towards the sound source, the pitch is higher than when 
you're moving away from the sound: the so-called Doppler 
effect. Why is this? 

Let's consider a simple beep which is represented by a 
sine wave. If we use an oscilloscope to plot a beep, we'll see 
something like Figure A. If we plot a beep an octave higher, we'll 
see Figure B, and an octave lower will look like Figure C. Notice 
that the waves of higher notes are more compact, and the waves 
of lower notes are more spread out. 

A sample of a beep is nothing more than a lot of numbers 
(x and y coordinates) which, when plotted onto a graph, will 
redraw the original curves. See Figure D, where each circle 
represents a coordinate. To turn the coordinates back into 
audio, the computer works through each x value and sends the 
corresponding y value to the speakers. The trick here is that the 
rate at which the computer works through the x numbers doesn't 
have to be the same as the rate at which they were recorded. 
In other words, the space (representing an amount of time) 
between each circle can be stretched or compressed. So, if the 


computer walks through the x values faster than the original rate, 
it will have the effect of squashing the circles closer together, 
which will result in a higher-sounding beep. It will also make the 
beep shorter, as we will work through all the circles faster. This is 
shown in Figure E. 


Finally, one last thing to know is that a mathematician called 
Fourier proved that any sound is actually lots and lots of sine waves 
all combined together. Therefore, when we compress and stretch 
any recorded sound, we're actually stretching and compressing 
many sine waves all at the same time in exactly this manner. 


Bringing it all together 

Let’s look at a simple piece combining these ideas. 
Copy it into an empty Sonic Pi buffer, press Play, listen 
to it for a while, and then use it as a starting point for 
your own piece. See how much fun it is to manipulate 
the playback rate of samples. As an added exercise, try 
recording your own sounds and play around with the 
rate to see what crazy sounds you can make. 


sample :bass_trance_c, rate: 1 
sample :bass_trance_c, rate: 2 
sample :bass_trance_c, rate: 9.5 


However, what if we just want to alter the rate so that 
the pitch goes up one semitone (one note up on a piano)? 
Sonic Pi makes this very easy via the rpitch: opt: 


sample :bass_trance_c 
sample :bass_trance_c, rpitch: 3 
sample :bass_trance_c, rpitch: 7 


live_loop :beats do 
sample :guit_em9, rate: [@.25, @.5, -1].choose, amp: 2 
sample :loop garzul, rate: [@.5, 1].choose 
Sleep 8 

end 


If you take a look at the log on the right, you’11 notice 
that anrpitch: of 3 actually corresponds to a rate 
of 1.892 and arpitch: of 7 corresponds to arate 
of 1.4983. Finally, we can even combine rate: and 
rpitch: opts: 


live _loop :melody do 
oct = [-1, 1, 2].choose * 12 
with_fx :reverb, amp: 2 do 


Sample :ambi_choir, rate: 0.25, rpitch: 3 16.times do 

Sleep 3 n = (scale 0, :minor_pentatonic).choose 
sample :ambi_choir, rate: 0.25, rpitch: 5 sample :bass_voxy_hit_c, rpitch: n + 4 + oct 
Sleep 2 Sleep @.125 

Sample :ambi_choir, rate: 0.25, rpitch: 6 end 

Sleep 1 end 

sample :ambi_choir, rate: 0.25, rpitch: 1 end 
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Tutorial STEP BY STEP 


Pi Zero 


PIR motion 
sensor 
magpi.cc/ 
2gCQKkPj 


Raspberry Pi 
Camera Module 
magpi.cc/ 28ljlsz 


Pi Zero camera 
cable adapter 
magpi.cc/ 
2gT2KwE 


Portable battery 


PISPY CAM 


Set up a motion-activated spy camera in your room to find out 
if anyone’s coming in when you’re not there 


e’ve all been there. You’ve gone out for the day 
and you know you closed your bedroom door, 
but you come back and it’s slightly ajar. Who’s 
been in there? Were they friend or foe? 


>STEP-01 

Connect up the camera 

Attaching the camera to the Raspberry Pi Zero is easy, 
and if you read our camera beginner’s guide you’ ll 
already have an idea. You’1] need to first switch out the 
cable in the Camera Module with the adapter for the 

Pi Zero. Gently pull down on the clasp that keeps the 
ribbon on the Camera Module attached and remove 
the cable. Take note of the orientation of the silver 


Avery simple Fritzing diagram 
just to make sure you know 
how to wire up the sensor 
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connectors on the cable you removed, and make sure 
your adapter cable is the same way round when you 
insert it. Put the other, smaller side into your Pi Zero, 
with the silver connectors facing towards the board. 


>STEP-02 

Wire up the circuit 

The circuit for this is fairly simple, especially as the 
PIR doesn’t need a resistor as part of its setup. The PIR 
comes with three connections: VCC, GND, and OUT. 
VCC needs to be connected to a 5V power pin, GND 
needs to go to a ground pin, and then there’s the OUT 
wire which will be our input. We’re connecting it to 
pin 8, also Known as GPIO 14. 

If your Pi Zero has GPIO pins attached, you can do 
this via a breadboard; otherwise you can loop the wire 
around the pin holes and use a bit of Blu-Tack to keep 
them in place, or a dab of glue from a glue gun ona 
low setting. Soldering is also an option. 


>STEP-03 

Get the code 

Write up or download our code for this project. This 
code uses two libraries: GPIO Zero and the standard 
picamera library. GPIO Zero can be used to geta 
reading from the PIR motion sensor very easily, which 
can then be tied into the picamera code so it takes a 
photo when motion is detected. We make sure the 
photo is given the time so you know when it was 
taken, and it then waits five seconds before seeing if 
it should take another photo. Save it as spy.py in the 
default home folder. 


>STEP-04 
Final preparations 


You can run it first to give it a test. You might want to 
change the sensitivity, which you can do by adjusting 
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the little orange screws on the side of the PIR board. 
Once that’s done, it’s best to make it so that when the 
Raspberry Pi boots up, it logs directly into command- 
line mode. This means it will use up a little less power 
so your battery lasts longer. It’s then a good idea to 
open up the terminal and edit the profile config file 
with sudo nano /etc/profile. To the bottom of the 
file, add this line: 


sudo python spy.py 


Now you need to 
find a good place to 
hide your camera 


Hide your camera 

Now you need to find a good place to hide your 
camera. The cable for the camera is limited by length, 
while the PIR can have its wires lengthened, so keep 
that in mind when building your system. Hiding the 
Pi and battery behind a plush toy or photo frame can 
work well; you could even put a dummy photo up and 
cut a hole in it for the camera to look through. The PIR 
has quite a wide range, so put it up high where people 
are unlikely to look. 
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Tutorial 


You should probably hide yours 
somewhere slightly better — its 
range is far, though 


Camouflaged against Yoshi, 
the camera will take candid 
snaps of anyone who comes 
close to your game collection 


“STIR E | Lt hth 


th iy 


Spy.py 


#!/usr/bin/env python DOWNLOAD: 


magpi.cc/PiSpy 


gpiozero MotionSensor 
picamera PiCamera 
datetime datetime 
time sleep 


sensor MotionSensor (14) 
camera = PiCamera() 


True: 
sensor.wait_for_motion() 
filename = datetime.now().strftime("%H.%M.%S 
camera. capture(filename) 
sleep(5) 


Check for intruders 

All you need to do now is plug in the battery and the Pi 
Zero will turn on and run the script. Do some tests to 
make sure the camera is facing the right way. Leave it 
running during the day and then when you get back, 
plug it into a monitor, stop the script, and run startx 
to get the GUI up. From here you can see the pictures 
it has taken — crucial evidence to catch your dog or 
sibling red-handed. 
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BOUNCY 
HEDGEHOG 


Tutorial STEP BY STEP 


Spike the hedgehog loves playing on the 
trampoline, but he’s a bit clumsy. Can you move 
the trampoline to stop him landing with a bump: 


64 


ho doesn’t love hedgehogs? Here we are 
going to make a simple Scratch game with an 
additional dose of prickly goodness, in which 
you use the cursor keys to move the trampoline left 
and right to catch a bouncing hedgehog target. This 
tutorial shows you how to bring in new sprites and 
backgrounds, and how to use the bracket blocks and 
diamond blocks in your projects. You’ ll find these 
skills useful as you build other things in the future. 
Start a new Scratch project, and get ready to bounce! 


>STEP-01 

Prepare your artwork 

For this Scratch project, you don’t need the cat sprite, 
so right-click it in the Sprite List and then choose 
Delete. To add a new sprite, click the icon above the 
Sprite List that shows a folder and a star. Add the 
trampoline sprite from the Things folder, then the 
fantasy11 sprite from the Fantasy folder. Let’s change 
the background too: click the Stage in the Sprite List 
and you will see that the Costumes tab changes to 

a Backgrounds tab. Click the tab and use the Import 
button to bring in your choice of background. For this 
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There are some 
great fantasy 
sprites included in 
Scratch, including 
this purple 
hedgehog-like 
creature! 


Move the 
trampoline left 
and right to catch 
the hedgehog and 
bounce it back up 
in the air. 


when clicked 


set size to &%) % 


goto x: @ y: 6) 


when left arrow key pressed 


change x by | 


when ‘ight arrow key pressed 


change x by 


project, we have chosen to use the atom-playground 
image from the Outdoors folder. 


>STEP-02 
Adding player 


controls when clicked 
Click on the set size to (%) % 
trampoline (which —— : 

should be Sprite1) point in direction 


in the Sprite List to 
Select it, and then 
click the Scripts tab 
above the Blocks 
Palette. Listing 1 shows the scripts you need to add to 
this sprite. Work your way down them, dragging the 
blocks into the Scripts Area one at a time and joining 
them up. Click the white holes in the blocks and type 
the right numbers in. Remember that the colours 

are a clue: to find the yellow blocks, click the yellow 
Control button above the Blocks Palette first. 


wait §} secs 
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when clicked 

set size to €%) % 
point in direction 
go to x: y! 


wait §9} secs 


repeatuntil jy position < 


>STEP-03 


Set up the hedgehog 

Click Sprite2 (the hedgehog) in the Sprite List. Add 
the script shown in Listing 2 to it. This puts the sprite 
at the top left of the Stage when the game begins, and 
gives the player a chance to spot it before it moves. 


clicked 


when 
set size to 36 
point in direction 
go to x: -200)| ¥: 
wait Secs 


repeat until y position < 


move € steps 
UW 


it on edge, bounce 


ty 


>STEP-04 

Add a repeat loop 

We’re now going to extend that script by adding some 
more blocks at the bottom of it. Listing 3 shows the 
entire script, including the bits you’ve already done. 
Click the Control button above the Blocks Palette. Drag 
arepeat until block into the Scripts Area and join it 
to your script so far. (Make sure you don’t use the repeat 
block with a number in it). Next, you need to dropa< 


2 ee 


New sprite: 


show 
export this sprite 
duplicate 


Above Right-click the sprite in the Sprite List to delete it (note 
that the buttons to add a sprite are found above the cat) 
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BOUNCY HEDGEHOG 


block into the diamond-shaped 
hole. Click the Operators button 
above the Blocks Palette to find it. 
Type -12@ into the box on the right. 
Finally, click the Motion button and 
drag the y position block into 

the left box. Now, whatever we put 
inside the repeat until bracket 
will be repeated until the sprite’s 

y position (how far up or down the 
screen it is) is less than -120. In our 
game, that means it has missed the 
trampoline and hit the floor. 


>STEP-05 

Make the hedgehog move 

To make the sprite move, add the two Motion blocks 
shown in Listing 4 into the repeat until block in 
your script. Click the green flag above the Stage to 
test it so far. You should see the hedgehog go to the 
top left of the Stage, plummet down, and stop when 
it reaches the bottom. 


a<i 
a- 
i-i 


and 


or 


when clicked 

set size to €%) % 

point in direction §09 

goto x: ¥: 

wart Secs 

¥ position < BEi) 
move 6 | steps 


' 
if on edge, bounce 
7 


repeat until 


if touching Spritel 7 


point in direction pick random @T} to 


Say for #2 secs 


>STEP-06 

Make the trampoline bouncy 

We need to make the hedgehog bounce back up again if 
it touches the trampoline. Click the Control button and 
drag an if block into your script. Be careful with where 
you put it: it belongs inside your repeat until bracket, 
as shown in Listing 5. Click the Sensing button and drag 
in a touching block for the diamond-shaped hole in 
your if block. Click the menu in the touching block to 
choose Sprite1 (the trampoline). Inside the bracket of 
your if block, adda point in direction 90 Motion 
block. Instead of putting a number in its hole, this time 
we ll use a pick random block with values of -45 and 
45. You'll find it in the Operators section of the Blocks 
Palette. Now the sprite will point in a random upward 
direction (between 45 degrees left and 45 degrees right) 
if it touches the trampoline. Finally, add a say block 

at the end of your script, outside all the brackets. This 
message is Shown when the game ends. 


Tutorial 


pick random §9 to §T:) 


Above 

The Operators 
blocks include the 
block for picking 
random numbers, 
and the blocks 

for comparing 
numbers 


SCRATCH 
ESSENTIALS 


Learn more 
about Scratch 
in our book 
Learn to Code 
with Scratch, 
which takes 
Wiel micelan 
beginner to 
pro. Find out 
more here: 
magpi.cc/ 
Scratch-book 


| Mag? 


LEARN TO 


SCRATCH 
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YOUR QUESTIONS ANSWERED 
NEED A 
PROBLEM 


FREQUENTLY geet 
A S K 5 D OQ U E S T | O) N S eminent 


to feature in a future issue. 


Your technical hardware and software problems solved... 4A 


Enable USB boot 
You’ ll need to boot normally via the SD card first 


to enable USB booting. You’!l need to edit the way 


Raspbian boots, so that you can then make the 
change to the Raspberry Pi itself before attempting 
to boot from USB. 


Prepare USB storage 
directly to it from the SD card. You’ll need to do some 


SD card partitioning magic on it to get it working properly, 
A micro SD card is the main boot option for the and it will probably work a bit better if you have 
Raspberry Pi, and the easiest to use. Images can be access to a Linux machine. 


burnt to the card or loaded via NOOBS. You can then 
use the card for storage if it’s big enough, or make use __ Full instructions 


of external storage options. The steps to create the USB-booting Raspberry Pi 
and appropriate USB media are a bit long for these 

USB pages, but you can read up on the full procedure on 

The space on SD cards is a little more limited than the Raspberry Pi website here: magpi.cc/2gaEyYt. 


what you can get on USB storage, flash or otherwise; 


so depending on how much data you’re using, it might 
be a good idea to create a USB-booting Raspberry Pi. 


Ethernet Debug boot mode 
The Raspberry Pi 3 added the ability for the Pi to be The initial preparation procedure is similar to booting 
booted over the network. This allows you to set up a over USB, albeit with a twist to make sure it tries to 
boot option for a Pi and then just plug Pis inas yousee — boot from the Ethernet port instead. You can start to 
fit. It?s great for businesses and enterprise solutions. capture data from the Ethernet after the change. 

lag sehr Configuration 


boot from an SD 


A few files and options need to be changed for 
card any more 


it to all work; this includes the DHCP request and 
reply, along with TFTP. It’s not massively complex, 
but you need to make sure you’re doing it right for 
it to work. 


Full instructions 

Ethernet booting is a lot more complex than USB 
booting, but there’s great info on it on the Raspberry 
Pi website that can help you to get it working: 
magpi.cc/2gTnVyR. You can also check out The MagPi 
#50 for a full guide on both. 
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Where is the on/off switch on the Raspberry Pi? 

There is no on/off switch! To switch on, just plug it in. To 
switch off, if you're in the graphical environment, first exit 

to the Bash prompt or open the Terminal. From the Bash 
prompt or Terminal, you can shut down the Raspberry Pi by 
entering the command, sudo halt -h. Wait until all the 
LEDs except the power LED are off, then wait an additional 
second to make sure the SD card can finish its wear levelling 
tasks and write actions. You can now safely unplug the 
Raspberry Pi. Failure to properly shut down the Raspberry 
Pi may corrupt your SD card, which would mean you would 
have to re-image it. 


What is NOOBS? 

NOOBS stands for New Out Of Box Software, and it’s our 
recommended installation method. It allows you to install 
the distro of your choice, even if you have little to no 
computing or Linux experience. 


YOUR QUESTIONS ANSWERED 


When will the next model of the Raspberry Pi 

be released? 

As of February 2016, the third generation of the Model B 
Raspberry Pi has been released. Beyond this revision, 
which upgraded the main processor on the board 

to a 64-bit version, there are no immediate plans to 
release any more new models. We concentrate our 
engineering effort on making the software that runs on 
the Raspberry Pi faster and better all the time, which is 
why you should always ensure that you are running the 
most recent firmware. 


What are the dimensions of the Raspberry Pi? 

The Raspberry Pi measures 85.60 « 56 x 21mm (or 
roughly 3.37 x 2.21 x 0.83 inches), with a little overlap 
for the SD card and connectors which project over 
the edges. It weighs 45g. The Pi Zero measures 

65 x 30 x 5.4mm (or roughly 2.56 « 1.18 x 0.20 inches). 


ieglel USB parent? and an SD card ¢ 
= », the WD PiDrive poundation Edition 
is your ideal storage salution for Raspberry Pi. Start creating 


projects in a matter of moments. 


WDLABS 


wdlabs.wd.com/products 
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£12.99 


200 pages of 


ss THE ' Official Raspberry Pi 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MdgPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
ee magpi.cc/MagPiStore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


9 Availab e on the GET IT ON 


App Store P> Google Play 
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RUN 
PIXEL, 


ON YOUR COMPUTER 


The PIXEL desktop is now available for Intel 

computers: use this month’s free DVD or burn a USB 

drive and get the best desktop interface on your laptop 
favourite computer. So we 


TT were delighted to discover 


that the Raspberry Pi Foundation 
was making a version of Debian with 
PIXEL for Intel machines. 

With this month’s physical version 
of The MagPi, you’ |l find a free 
DVD. Load this up on your laptop or 
desktop and you’ll find it’s just like 
using a Raspberry Pi. 

If you don’t have a Debian 
with PIXEL DVD, don’t worry. 

The Raspberry Pi Foundation has 
made Debian with PIXEL available 
as a downloadable ISO file. 

You can use the ISO file to create 
your own Debian with PIXEL DVD, 
or to build yourself a bootable USB 
drive to run the PIXE dese 
on your computer. 

In this feature, we’ll show you how 
to boot your computer into Debian 
with PIXEL and what you can do with 
the OS on your home computer. We’1l 
also look at saving files and creating 
a USB drive that you can use to boot 
into PIXEL on any computer. 


he Raspberry Pi is by far our 


USB DRIVE 


We'll show you how to create a USB 
drive of Debian with PIXEL for your 
computer. The USB drive is faster 


than the DVD, and you can save 
your work directly to it. 
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Tip ose elec ee LB may ION - O X 


The PIXEL desktop runs on your 
computer just like on a Raspberry 
Pi. It sits on top of Debian, the 
same Linux OS that is compiled for 
ARM to create Raspbian. 


DVD DRIVE - O X 


Load Debian with PIXEL using the 
DVD-ROM. It runs straight from 
the DVD and wontt interfere with 
your primary operating system. 
Remove the DVD and restart your 
computer when 

you've finished. 

You'll restart 

in your regular 

operating 

system. 
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H YOUR FREE DVD 


Load up the PIXEL desktop on any computer with a 
DVD-ROM drive and use it just as you would on a Raspberry Pi 


ebian with PIXEL is designed to be as easy to 


use as possible. So it’s no surprise that running 
the DVD on your computer (whether it is a Mac, 
| Linux, or Windows machine) is straightforward and 
Welcome ta pie. | simple. It’s just like using Raspbian on a Raspberry Pi. 
hie Boot a computer with the DVD inserted into the 
drive and itll load into Debian with PIXEL instead of 
its regular OS. It’s as simple as that! 
With the DVD inserted, you can work on your 
_ computer just as you would on a Raspberry Pi. 


———— 


ay lenovo 


Debian with 
PIXEL DVD 
Mac or PC 
DVD drive 
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Start up 

Turn on your computer and insert the DVD into 

the drive. Needless to say, you’ ll have to be using a 
computer with a DVD drive. If your computer hasn’t 
eot one, then you’|l need to create a bootable USB 
flash drive to run Debian with PIXEL —- see page 76. 

If you are using PC-based hardware, it doesn’t 
matter if you typically boot into Linux or Windows. 
Most PC computers are set up to boot from the DVD 
drive before the hard drive. You should hear the DVD 
spin and see ‘Welcome to PIXEL powered by Debian’ 
instead of your usual operating system. 

If you’re booting from an Apple Mac computer, then 
you can either hold down the C Key on your keyboard 
when you hear the Apple ‘bong’ noise, or hold down 
ALT and choose the DVD as the startup disk. 


The boot process 


After a short while you’ll see a screen displaying 
‘Debian (Jessie) with PIXEL i386’. You will also see 
‘Press Esc for options’ and a timer counting down. 


BOOT MENU - O X 


y, Pressing ESC while booting into 
Debian with PIXEL brings up the 
‘Op Boot menu options. Here you'll see 


two options: ‘Run Debian’ and ‘Run 


Debian without Persistence’ 

If you don't press ESC, it will 
automatically pick the first option. Persistence is 
something we'll look at a Lot in this feature. It enables 
you to save changes to the OS while working from the 
DVD or a bootable USB drive. 

Picking Debian without Persistence may help you 
boot into Debian, although you won't be able to save 
any files or changes you make to the OS. 

Press TAB to view the command-line boot for the 
option you have selected. Here you can add and 
remove specific options. Adding nomodeset after 
686-pae can help some older Macs boot. 

When you're happy with the boot option, press 
ENTER to boot the DVD. 


Debian (jessie) with PIXEL 
is B6 


Build: 2016-11-17 
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ri pills - OO X 


y, We found Debian with PIXEL to 
be reliable on our test PCs. If it 
‘OP doesn't start, you probably need 

to adjust your BIOS (Basic Input/ 

Output System) settings. Press F1 

on your keyboard (or follow the on- 
screen instructions) after starting up, to access the BIOS 
settings. These are the default hardware options for 
your computer (the settings that don't depend on the 
operating system). Use the arrow keys to move around 
and look for Startup and Boot. On our ThinkPad, it is 
called Boot Priority Order. Use the + and - keys to move 
the DVD drive to the first position. Choose Save and 
Exit, then Yes to reboot and try again. 


Don’t press anything. When the counter hits zero, 
you’ ll see ‘Loading, please wait’. 

You need to be patient when loading from a DVD. It 
may take a long time to start, depending on the speed 
of your DVD drive. Be patient. 


Logging in 

During the boot process, you will see the ‘raspberrypi 
login’ appear on the boot screen. Don’t enter any text; 
you will be logged in automatically and taken to the 


You can work on your 
computer just as you 
would on a Raspberry P1 


PIXEL desktop interface. The default username is pi, 
and the password is raspberry. 


Using Debian with PIXEL 


You can now use Debian with PIXEL on your computer 
just as you would on a Raspberry Pi. Be aware that any 
files you create aren’t saved when you finish. Choose 
Menu > Shutdown > Shutdown when you’ve finished, 
to switch off the operating system. 
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USING THE DVD 


Start using Debian with PIXEL on your computer 


NETWORK x 
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PACKED WITH PROGRAMS 


r= 
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The team has curated the best 
office and coding software 
around. This software makes 
Debian with PIXEL an ideal 
creative and learning system. 


Vela ie Dies Olle | emenCie 


SB DLE |]} Aesprery i- Teach. 
@ Programming > * 


@ Raspberry Pi-Tes 


CGC 6 http: 


www raspberrype org 


You can connect the OS toa 
local wireless network and 
use the built-in Chromium 
web browser (with Flash) to 
access online resources. 


Raspberry Pi - Teach, Leam, and Make with Raspberry Pi - Chromium 


DOWNLOADS 


hen Debian with PIXEL has loaded, you can 
use your computer just as you would use a 
physical Raspberry Pi. 

Start by clicking the Menu icon in the top-left to 
access all the built-in software. Here you’ ll find the 
finest collection of programming tools and educational 
resources around. Debian with PIXEL also comes with 
LibreOffice, a strong alternative to Microsoft Office. 

The programming tools are where it really shines. 
Programs like Greenfoot Java, Scratch, and Sonic Pi are 
all available. It even has the Sense HAT Emulator and 
links to all of the Raspberry Pi help and resources. 


Get online 


One of the first things you’ 1] want to do is connect 
Debian with PIXEL to the internet. Click on the 
Network icon in the menu bar to view local wireless 


17 


PloNEERS 


7 /> 


PIONEERS: 
#MAKEYOURIDEAS 


PAE BDESKiOr x 


I 
I 

I 

I 

I 

I 

I The PIXEL desktop on your 
regular computer looks and 
works much as it does ona 
Raspberry Pi. This makes it 

I ideal for learning to code. 

I 


networks. Choose a network and enter the password 
(the ‘Pre-Shared Key’). Alternatively, if your laptop 
aeraiee tener sockel, you can use an Ethernet cable 
to connect directly to a network or your home router. 

Once you are online, it’s possible to browse the 
internet using the built-in Chrome browser with 
Flash support. You can also download software to 
Debian using APT. 
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Programs you install using APT are stored 
in memory and can be utilised until you shut 
the computer down. 

When you turn off Debian, all the files you have 
created (and the programs you have installed) are 
wiped from the system. This refresh can be useful. 

Without a persistence drive, Debian with PIXEL starts 
up as a fresh install each time, making it handy as a 
teaching tool. Be careful not to lose any files, though. 


Persistence drive 
If you want to be able to save files, and keep programs 
you’ve installed, you’1l need a persistence drive. 

The persistence drive works in tandem with your 
DVD. The DVD disc is used to boot the computer, and 
files you save into your home folder are stored on the 
USB drive, but everything works as a single volume. 

icabinie awpcisisicmeoanive 1s Pretty Simple, YOU 
format a USB drive in a Linux format (typically ext4) 
and give it the label persistence. 

After formatting the drive, you need to create a 
configuration file on the root of the drive. The file 
is called persistence.conf and contains the text: 

/ union. This configuration file tells the USB 
partition to work in union with the DVD. 


Format the drive 

The easiest way to format a hard drive is to use an app 
called GParted. Open a Terminal window and enter sudo 
apt install gparted. When this is finished, enter 
sudo gparted to run the program with sudo privileges. 

Click the Disks menu in the top-right of GParted (it 
should say /dev/sda) to view your hard drives. There will 
be one option for each drive on your computer. 

Now attach your USB drive and choose GParted > 
Refresh Devices (or press CTRL+R). Click the Disks 
menu again and you’ll see the new option. 

Typically it'll have the smallest amount of space 
(measured in GiB). Be careful to select the USB drive 
and not your primary hard drive. 


Peo eINCe Dini 


oe (03 BE) Blssccee - t pea - 


Install GParted to format a USB drive and create a 
persistence drive. This drive is used to save files and 
changes you make to the Debian OS. 
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We caught up with Eben Upton, 
co-founder of the Raspberry Pi 
and CEO of Raspberry Pi Trading, 
to discuss the creation of Debian 
with PIXEL for Intel machines. 

“I guess the real questions is 
‘why didn't we do it earlier?’,” 
Eben tells us. “People used 
to say to us things like: ‘why 
aren't you doing software?’ and 
‘everyone's got a PC*” 

The answer back then was: 
‘everyone doesn't have a PC’ 
and ‘people are scared to break 
them, so they don't want to get 
their hands dirty’. 

So the Raspberry Pi Foundation 
concentrated its efforts on making 
hardware for a long time and the 
software for the Raspberry Pi was 
generic for a large part of that 
time. “Then Simon [Long] joined 
us,” says Eben. 

Simon has done an enormous 
amount of work to transform 
the stock Raspbian desktop 
into the much more polished 
PIXEL experience. 

One thing that's superb is 
“the curation,” explains Eben. 


\7 NS 


Software like Flash, Chromium, 
Java, and LibreOffice requires a 
lot of effort to get on board. “It’s 
getting close to being the perfect 
environment for productivity and 
learning to code. 

“We've now got a piece of 
software that’s pretty interesting. 
The question became: ‘why are we 
forcing people to buy a Raspberry 
Pi to run it?’ 

“So we've come full circle,” 
Eben concludes. “We're giving ita 
go to see if people like it.” 


First, right-click the long horizontal bar and choose 
Unmount (if it is available). Next, right-click on each 
partition in the list and choose Delete until you see a 


erey horizontal bar with ‘unallocated’. 


Choose Partition > New. Enter persistence in the 


Label field and click OK. 


Finally, click the green tick icon (Apply All 
Operations) and click Apply in the alert window. 


Configure the drive 


Now we need to add a persistence.conf file to the root of 
our formatted disk. Remove and reinsert the USB drive. 
Enter cd /media/pi/ and sudo chown pi 
persistence to change ownership of the drive. 
Next, enter cd persistence/ to move to the root 
of the USB drive, and then sudo echo / union > 


persistence.conf. 


The echo command writes ‘/ union’ to a file called 
persistence.conf on the root of your hard drive. You 
can check it using cat persistence.conf. 

Now all you need to do is restart your computer. 
Enter sudo reboot. The computer will boot from the 
DVD drive, and use the persistence USB drive. 
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MAKE A 


DEBIAN 


WITH PIXEL 
USB DRIVE 


Venues) What if you haven’t got a DVD drive: 


pie Don’t worry: you can create a bootable USB drive... 
> USB drive ; 
> Debian any newer computers don’t come with Getti Ng the ISO 
with PIXEL DVD-ROM drives. So what happens if you You’ll need the Debian with PIXEL ISO file. You can 
ISO file want to run Debian with PIXEL on your turn the DVD-ROM into an ISO file using a program 
computer, but you don’t have a drive? called InfraRecorder in Windows (magpi.cc/2fP6wZT), 
The answer is pretty simple: create a bootable USB Disk Utility in Mac OS X, or by using the dd command 
flash drive from the Debian with PIXEL ISO file. in Linux. However, it’s better to download the latest 
Most modern computers can boot directly from version of the ISO from the Raspberry Pi Foundation’s 
a USB drive. This drive is faster and slightly more website (magpi.cc/1MYYTMo). 
reliable than using a DVD (and older laptops can have 
flaky DVD-ROM drives). Using Etcher 


You can partition a USB drive to contain both Debian There are many ways to turn the ISO file into a 
with PIXEL and the persistence drive. It’s like having bootable drive. We find it easiest to use the Etcher tool 


a Raspberry Pi in your pocket that you can boot on (etcher.io). We looked at Etcher in-depth in issue 50 
virtually any other computer. of The MagPi (magpi.cc/Back-issues). 
Sounds fun? Let’s make one! We generally use Etcher to create SD cards to boot 
up our Raspberry Pi, but it turns out to be just as 
FIX A MISSING MENU BAR _ eo x handy for burning bootable USB drives. 
Svemorenet and click select Image. Choose the ISO 
Occasionally we found the PIXEL file containing the Debian operating system. Now 
menu bar didn’t appear. In this insert your USB drive. It may appear automatically 
case press CTRL+ALT+F1 to switch under Select Drive (otherwise click Select Drive and 
to another session (enter pi and choose the correct disk). Click Flash! to copy the 
raspberry to log in). Now enter ISO file to the USB drive. Enter your password, if it’s 
sudo pkill lxsession to fem Wesred, and click OK. 
restart the LXDE environment. You'll be taken back ; 
to the PIXEL interface with a login screen. Starti Ng up 


Now restart your computer with the USB drive 
attached. If you have been using the DVD, don’t 
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SELECT IMAGE 


live-image-i...6.hybrid_iso 


“SETCHER 


forget to remove it from the drive first, or you’ ll boot 
from that instead of the USB drive. 

Many PCs are set up to boot from a USB drive 
before the primary hard disk, but if yours is not, you 
may need to access the BIOS settings and change 
the boot order (press F1 or follow the on-screen 
instructions during startup). 


If you installed Debian with PIXEL using an ISO file 
you created from the DVD, you will need to turn the 
remaining space on the USB drive into a persistence 
partition. You won’t need to do this if you installed 
Debian with PIXEL using an ISO downloaded from the 
Raspberry Pi Foundation website (it includes a script 
that automatically creates the persistence partition). 
Open a Terminal window and enter sudo apt 
install gparted. When it’s finished, enter sudo 
gparted to run the program with sudo privileges. 


If you're struggling to get the 

USB drive to start up on a Mac, 

try formatting the drive into 

two partitions. The first partition 

should be FAT32 and 1.5GB in 

size with a boot label. The rest 
of the drive should be a Linux ext4 partition with 
the label persistence. You then use 72z to unzip the 
contents of the ISO into the FAT32 partition. We 
found these instructions on CosmoLinux helpful: 
magpi.cc/2ggdzrs 
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© Need Help? @& 


SELECT DRIVE 


resin.to 


Use 
Etcher to 
record the 
ISO file into 
a bootable 
Debian USB 
drive for your 
computer 


With your 
USB drive, 
you can boot 
directly into 


: : , Debian with 
Click on the Disks menu and choose the USB drive PIXEL: it's just 
from your disks. It should be the smallest drive. like using a 
Raspberry Pi 
Right-click on the grey horizontal bar marked computer 


‘unallocated’ and choose New. 

Enter persistence in the Label field and click Add. 
Click the green Apply icon and click Apply in the Apply 
Operations to Device alert window. Click Close when 
you see ‘All operations successfully completed.’ 

Restart with sudo reboot. This will mount both the 
boot volume and the persistence volume. 

Open a Terminal window and enter cd /media/pi. 
Here you will see the mounted persistence partition 
(enter 1s -1 to view the volume and its permissions). 
You need to take ownership of it to make changes. 
Enter sudo chown pi persistence to take change 
the ownership of the drive from root to pi. Enter 
ls -1to view the permissions again. 

Use cd persistence/ to move to the root of the 
drive. Enterecho / union > persistence.conf 
to create the persistence configuration file. Use cat 
persistence. conf to check the contents of the 
configuration file. It should be just ‘/ union’. 

Enter sudo reboot one last time. You will now 
boot into Debian with PIXEL from your USB drive. 
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Maker 
says 
It's easy 

to build and 

lots of fun 


to use 
Mime Industries 


ARCBOTICS 
SPARKI 


The Sparki 
comes with 
sensors missing 
from the 
Mirobot and 

an on-board 
display, but it's 
considerably 
more expensive 
as aresult. 


£145/$149 


arcbotics.com 


MIROBOT V2 


PROGRAMMABLE ROBOT 


Platftorm-agnostic and tool-free, could the Mirobot be the perfect 
first robot for budding makers? 


hen a Mirobot drops 
through the letter box, it 
comes as a real surprise. 
Whereas most robots come in bulky 
packaging, the Mirobot sits ina 
simple cardboard box the size of a 
few stacked CDs. It’s easy to assume 
that it’s small as a result, but it’s 
actually testament to creator Ben 
Pirt’s talents: the packaging for the 
Mirobot becomes the robot itself. 
The Mirobot’s body is constructed 
from laser-cut wood, and the kit 
takes the form of sheets of wood 
with the pieces still in place. Holes 
are cut out for the non-wood 
components, like the motors and 
circuitry, and the whole lot carefully 
assembled and held together with 
two elastic bands at the corners. 
The result: very little goes to 
waste. The outer framework from 
each slab of wooden components is 
useless once popped out, but can be 
disposed of as compost or used as 
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fuel in a fire, while everything else 
bar the cardboard outer gets put to 
use, even the elastic bands. 

The build process is tool-free and 
simple: someone with no experience 
of electronics can easily follow the 
instructions, printed in colour with 
illustrative photographs, and end up 
with a working Mirobot in around 
10 or 20 minutes. The only slightly 
tricky steps are inserting the non- 
keyed wires into the main circuit 
board, which must go ina specific 
way around, and calibrating the pen 
using the included tool, laser-cut 
from wood, as with everything else 
in the kit. 


Ease of use 

Once built, the Mirobot is powered 
by four AA batteries and operates 
entirely independently. Initially, 
the on-board wireless hardware, 
which uses the low-cost ESP8266 
WiFi module, broadcasts as an 


unencrypted hotspot to which you 
can connect a smartphone, tablet, 
Raspberry Pi, or laptop in order to 
configure the device. 

Here’s the second surprise: 
there’s no software to install. 
Everything on the Mirobot, 
from upgrading its firmware to 
programming it, takes place in 
your web browser. You can choose 
to use it offline in unencrypted or 
encrypted hotspot mode, or give 
it your WiFi details to connect it to 
your home or school network. 

If you choose the latter, you 
gain access to the Mirobot Apps 
from the official website. These 
offer a wide range of choices for 
programming the robot: a spartan 
drag-and-drop block-based user 
interface which is available locally; 
the Blockly, Snap!, and Scratch 
block-based languages, though the 
latter is Adobe Flash-based and 
unavailable from a Raspberry Pi; 
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Right The full 
kit comes with 
a chassis to put 
your robot on 


Python or JavaScript text-based 
languages, complete with in- 
browser development environment 
and syntax highlighting; anda 
point-and-click interface for easy 
drawing. There’s also a direct 
remote control option, which 
allows you to control the Mirobot 
using on-screen buttons; coupled 
with a smartphone, this turns the 
Mirobot into an admittedly slow 
remote-controlled car. These are 
all available for offline use, too, 
through a Chrome app which can be 
installed into Google’s web browser 
on all supported operating systems. 
In use, the Mirobot acts like 
your average turtle robot. It can 
raise or lower the pen, which you 
must provide yourself, to draw 
shapes on paper, turn in either 
direction, move forwards and 
backwards, and emit a beeping 
noise from its on-board speaker. 
The updated kit, now in version 2.0, 
also includes an optional infrared 
sensor, which when installed can 
be used to turn the Mirobot into 
a line-following robot. 


More to learn 

The manual does, however, stop just 
short of where an absolute beginner 
might have liked. In particular, 
you’ ll find no reference to fitting 

the line-follower in the printed 
documentation, the need to calibrate 
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MIROBOT V2 PROC 


Thi pt 


ents oi oor 


the pen’s position and height, and MirebotApps @ 


calibrating the distance the robot _— rom polygons 


travels by drawing and measuring a 
line, in order to produce clear shapes 
from your programs. Blockly oe (— Javascript 
Fortunately, the official website poyenmemgemebee | | Sane lp wich a me a sven are 
includes a learning resource section 
with easy-to-follow guides for as 
all these tasks. Cleverly, they’re —<aaw ove | Mi | ae Cy 
also capable of connecting to any = SP a oecene 
Mirobot on your local network: the a pid cis Soppancnn aren nai oe 
page for calibrating the motors, — your browser 
for example, allows you to press 


_— 


a button to draw a line, then type cor | 
in the length once measured, the SRA TCR 
Pad 


result of which is sent back to the 5 ee 
robot and stored in its permanent ad yoriNe | | hmebod Wequees Plan] 
memory automatically. You’ll also 

find guides to drawing shapes, using 

the line-follower, and technical Above Program your robot from a web browser for maximum ease 
documentation on the Mirobot’s Below It comes with WiFi built into the board so you can access it 
communications protocol. 


fast word 


It's impossible to dislike the 
Mirobot. From its simple tool- 
free build process and clever 
packaging to its browser- 


based user interface, the 
machine is a Joy from the 
moment it arrives and a sure- 
fire hit with younger makers. 
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Maker 
Says 


Makes 
the creation eee 
of one-off Nein a 
projects and . 
prototypes 
gs simple 
gs possible 


MonkMakes 


Related 


ADAFRUIT 
PERMA- 
PROTO 


Available in 
three sizes, this 
PCB prototyping 
board matches 
the design 

of a classic 
breadboard, 
without the 
extra connectors 
you find on the 
MonkMakes 
ProtoBoard. 


£10 / $13 
magpi.cc/2fPNZwh 
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PROTOBOARD 


A PCB breadboard-style prototyping board with extra features 


ike many electronics 
hobbyists, Simon Monk 
likes to prototype projects 
on a solderless breadboard before 
transferring them to something 
more permanent once everything 
is tested and working correctly. He 
says he’s never been completely 
satisfied with other prototyping 
board designs, though, so he decided 
to address what he saw as their 
shortcomings. The result is the 
MonkMakes ProtoBoard. Following a 
successful Kickstarter campaign, it’s 
now available as a deluxe kit from 
Amazon (amzn.eu/3YhwMak). 
Inspired by Adafruit’s Perma- 
Proto boards, the ProtoBoard 
mirrors the layout of a standard 
solderless 400-point breadboard, 
featuring the usual interconnected 


.. Tails and rows, but adding longer 
“ rows at the bottom of the board 


for modules that use 2x4 or 2*5 
pins, such as the ESPo1 or NRF24 
modules: a nice touch. 

The most obvious difference, 
however, is the addition of an area 


on the right-hand side where you 
can put extra components that 
don’t fit straight onto a breadboard. 
These include a standard ‘sugar 
cube’ relay, 3.5mm audio jack, and 
general-purpose screw terminals. 
There’s also an area at the top for 
creating a power supply by adding 
a barrel jack and linear voltage 
regulator and capacitors. This can 
be connected to one or more power 
rails by soldering the +V and GND 
bridges on the board. 

Two packs of components are 
supplied in the deluxe kit available 
from Amazon, along with a half- 
size solderless breadboard and four 
rubber feet. When prototyping 
projects, Simon advises sticking 
the breadboard permanently to 
one of the ProtoBoards and adding 
a full set of components to the 
side panel. Then, once your circuit 
is working as intended with this 
setup, it should be very easy to 
transfer (or copy) breadboard 
components to another ProtoBoard 
placed to the side, as well as 


replicating any components used 
in the side area. It’s aneat idea 
that really does help. 

As well as being suitable for any 
project that you could start with a 
400-point solderless breadboard, 
the ProtoBoard can be used for those 
that feature a microcontroller such 
as a Particle Photon or Arduino Pro 
Mini — you could even use it to make 
an off-board Arduino. 


fast word 


With a well-thought-out 
design, the ProtoBoard 
makes it easier to transfer 
projects from a solderless 
breadboard to a more 
permanent PCB, featuring 


through-plated connection 
holes. In particular, the side 
panel comes in very handy 
for components that don't fit 
straight onto a breadboard. 
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MOTE HOST 


The original 
Mote controller 
plugs into the 
USB port of 

any computer, 
including Pi 3, Pi 
2, or B+. Like the 
pHAT, it features 
four micro USB 
outputs. 


£11/$14 
magpi.cc/2g9iyLs 
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MOTE PHAT 


A more compact way to control Mote light strips 


eaturing 16 super-bright 
RGB LEDs, Pimoroni’s 
Mote ‘stick’ light strips 
(£8.50 each) are ideal for under- 
shelf/cabinet mood lighting, among 
other applications, and can be 
used to create some impressive 
effects. Until now, a Mote Host 
has been required to control 

the sticks, plugging into any 
computer — including the Pi — 

via USB. For a far more compact 
and convenient setup, the Mote 
pHAT does the same job. Its pHAT 
form-factor matches that of the 
Pi Zero perfectly, so you can tuck 
it discreetly away out of sight. You 
will need to solder the female 
GPIO header onto the Mote pHAT 
first, although at least this does 
give you the option of using a 


» Stacking header to use it alongside 


other add-on boards: you could 
get Mote sticks to display sensor 
readings from an Enviro pHAT, 
for example, or control them with 
buttons or switches. 


As with the Mote Host, there 
are four output channels via 
micro USB ports for controlling up 
to four Mote sticks independently 
of each other. A Python library 
(magpi.cc/2fw40FX) is provided, 
along with a few examples to get 
you Started. These include an 
impressive rainbow effect, colour 
cycling, and CheerLights web 
control via Twitter. The library 
itself is easy to use, enabling you 
to set each individual RGB pixel on 
each of the four channels. They are 
triggered with a show command, 
and clear is used to turn them off. 
Using a for loop, we soon managed 
to create a simple chase lights 
effect — handily, if you exceed the 
highest pixel number, it wraps 
round to the start of the strip 
again. Since the LEDs are APA102 
standard (aka DotStar) witha 
fast data rate, there are none of 
the timing issues you might get 
with NeoPixels and they respond 
almost instantaneously. 


Run our 
beautiful 
Mote lights 
Straight from 
your Pi or 


P| Zero 
Pimoroni 


You can even control them 
from your phone or from a web 
browser by setting up a Flask API. 
Pimoroni’s step-by-step tutorial 
(magpi.cc/2g92g143) shows how to 
use Homekit to control the lights 
from an iPhone, using Siri voice 
commands to turn them on and off 
and to set the colour — a good way 
to impress friends! The same result 
should be possible using Google 
Assistant or Alexa, too. 


fast word 


The Mote sticks are excellent, 
even better than NeoPixels, 
and the new Mote pHAT offers 
a compact, discreet way of 
controlling them without the 


need to connect to the USB 
port of a laptop or Pi. At just 

£5 it's great value, although of 
course you'll still need to buy 
sticks (and cables) to use with it. 
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Just 
enough OS 


for Kodi 
LibreELEC 


OSMC 


OSMC 
dispenses with 
the standard 
Kodi interface 
to use its own 
take. This makes 
it flow slightly 
differently while 
still having a 
strong base. 


Settings 


System 


Network 


mMcy 


Connections 
Services 
Bluetooth 


About 


i imedatas 
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System Name 
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Aeler-ige 


Keyboard Layout 


Keyboard Layout Variant #1 


Keyboard Layout 


Keyboard Layout Variant #2 


Keyboard Type 


Automatic Updates 


14:40 


Tuesday, 12 July 2016 


LibreELEC 


pc105 


manual 


Configure a hostname, keyboard type, perform a reset, update, or backups and restores 


LIBREELEC 


A new media centre OS for the Raspberry Pi with familiar ancestry, 
is LibreELEC an upgrade over OpenELEC?: 


t’?s been a while since 
we’ve looked at a new 
media centre for the 


Raspberry Pi. The ‘market’, for lack 


of a better term, has been wrapped 
up for a little while now by OSMC 
and OpenELEC, so it’s not like 
there’s been much call for another 
one. Both are great and offer 
something slightly different over 
the other, so unless you’re going 
to reinvent the wheel, there’s not 
much more to add. 

Which brings us to LibreELEC. 
It doesn’t reinvent the wheel, but 
what it does is out-OpenELEC 
OpenELEC; it’s probably the 
slimmest and most lightweight 
Kodi (née XBMC) OS you’ |] find. 
This comes as no surprise when 
you learn of LibreELEC’s lineage 
as an offshoot of OpenELEC 
itself. If you know your open- 
source software, it’s a little bit 
like OpenOffice and LibreOffice, 
albeit with no corporate 
buyouts involved. 


MagPi January 2017 


LibreELEC aims to carry on the 
more open, free spirit of earlier 
OpenELEC releases, while still 
staying at the bleeding edge of 
Kodi’s release schedule. There’s 
also a commitment to stability, 
which is very welcome. You can 
see their cutting-edge credentials 
on the website; as Kodi ramps up 
to release version 17, each beta 
release is closely followed bya 
pre-release of the next LibreELEC. 

For this review, we’re 
concentrating on their stable 
release at the time of writing, 
LibreELEC 7.0. Installation is a 
doddle and it’s handled by software 
developed for all major platforms 
(including a generic Linux one!). 
This software allows you download 
an image (stable by default, but 
you can select the beta), choose a 
destination for the image, and then 
burn it. It’s easy to use and very 
fast as well, although the speed is 
probably down to how small the 
image itself is. Usually something 


like Raspbian can take up to ten 
minutes to burn to an SD card, 
whereas LibreELEC was done ina 
minute. There’s even a progress bar 
to keep track of it. OpenELEC had a 
similar piece of software, but it was 
never quite as developed as this. 


Media consumption 

First boot is easy and familiar, 
too. The SD card is resized to 

fill the space, and a couple of 
other minor tasks are performed 
before it reboots into the media 
centre. The reboot countdown 
timer takes longer than the initial 
operations on a Raspberry Pi3, 
and the true first boot itself is over 
pretty quickly. 

From here things start to look a 
lot more familiar. LibreELEC comes 
with the default version of Kodi, 
rather than a reskinned one like 
OSMC. You’re asked some basic 
details, and then it immediately 
allows you to connect to WiFi using 
the Raspberry Pi 3’s on-board 
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wireless. It also has a pretty good 
range of codecs for WiFi dongles 

if you’re using a Pi 2. With that 

set, you’re done and ready to 

Start adding media sources. This 
was one of the nice things about 
OpenELEC: it was fast and simple, 
offering the Kodi environment a lot 
of people are already familiar with. 


work absolutely fine on the Pi 2 
and Pi 3. Particularly in the case 
of OpenELEC, unless you’re 
experiencing issues it’s not really 
worth the hassle of reinstalling 
and getting all your media set 

up again. While LibreELEC does 
also support first-generation 
Raspberry Pis (and the Pi Zero), 


The way LibreELEC 1s built 
seems Just that little bit more 
optimised for the Raspberry P1 


Using it feels just a little bit 
faster and smoother as well. Since 
the Pi 2 release, Kodi hasn’t had 
any issues on the Pi, but the way 
LibreELEC is built seems just that 
little bit more optimised for the 
Raspberry Pi. The UI flows well, 
media playback works absolutely 
fine, and it didn’t break at all 
during testing. There’s no sacrifice 
in terms of functionality or ease of 
use, either. 

It’s not exactly a game-changer, 
though. OpenELEC and OSMC 
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you’ re still limited a bit by the 
CPU on those lower-powered 
models, so again there’s not much 


of a difference in the performance. 


Kodi 17 is just on the horizon, 
though. The software releases 
fairly regularly as it is, but this 
could make for a shift in the way 
the Pi media centres perform in 
the near future. With LibreELEC 
working closely with Kodi, much 
like OpenELEC does, we’ re very 
interested to see how this next 
generation of OSes will perform. 


LIDNEELEU /.U 


Left Welcome to 
Kodi, powered by 
LibreELEC 


LibreELEC 


© Select veraon 


Raspberry Fi 2 and 3 ba 


Show all ¥ 
LibreELEC-RPi2.arm-7.90.009.img.gz, 122 MB 


2) Download or select a local image file 


Download Select file 


Select your USS stick or 50 card 


G:\ [7.4.68] 


© Write image 


Above The 
installation tool 
is quick and easy 
to use 


fast word 


If you like your Kodi default, 
clean, and lightning fast, 
LibreELEC is the OS for you. 


May not be worth the hassle 
of an upgrade if your current 
HTPC Pi is working fine, though. 


January 2017 MagPi | 33 


B4 


RASPBERRY PI 
BESTSELLERS 


The latest Rails can do anything; 
probably even make your coffee! 


LEARNING RAILS 5: 
RAILS FROM 
THE OUTSIDE IN 


Author: J Mark Locklear 
Publisher: O'Reilly 
Price: £31.99 

ISBN: 978-1491926192 
magpi.cc/2gFZC78 


Avery good intro book, but 
errors in code mean you'll also 
learn from debugging as you 
go along. Sample projects build 
very logically through learning 
how to ‘do’ Rails. 


RUBY ON RAILS 
TUTORIAL 


Author: Michael Hartl 
Publisher: Addison Wesley 
Price: £40.69 

ISBN: 978-0134598628 
railstutoriaLorg 


Hartl's comprehensive 

boot camp of a book (and 
online read) is highly praised 

by those who suit his immersive 
teaching methods. An excellent 
grounding, well updated for 
Rails 5 features. 


AGILE WEB 
DEVELOPMENT 
WITH RAILS5 gq 


Author: Sam Ruby 

Publisher: Pragmatic 
Bookshelf 

Price: £32.99 

ISBN: 978-1680501711 

magpi.cc/2gGimNr 


A beginner's guide into which 
agile, Ajax, REST, testing, 

and many best practices are 
closely woven into both its 
warp and its weft. Clear and 
thoughtful updates for Rails 5. 
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FREE TO MAKE 


Authors: Dale Dougherty 

& Ariane Conrad 
Publisher: North Atlantic Books 
Price: £17.50 
ISBN: 978-1623170745 
magpi.cc/2gFUrnw 
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Few revolutionary ell 
changes in the past 
have been as well 
chronicled as the still 
nascent maker movement, but if 
anyone is well-placed to give that 
commentary, it’s Make: magazine 
and Maker Faire founder Dale 
Dougherty. As well as the who, 
what, and where of the movement, 
Dougherty gives us a philosophical 
background to this “global 
countercultural phenomenon”, 
which empowers people to move 
away from passive consumerism. 

This exploration starts off 

with a look at the diverse range 
of makers — and their projects 
— spurred on by a love of what 


UNDERSTANDING 
ECMASCRIPT 6 


Author: Nicholas C Zakus 
Publisher: No Starch 
Price: £24.99 

ISBN: 978-1593277574 
magpi.cc/2gFYgsZ 


ECMAScript 6 isa 

huge set of changes to 

JavaScript — everything from 

Promises, to improve asynchronous 

programming, to several 

improvements to the good old array. 

What’s needed to get the average — 

or even occasional — JS coder up to 

speed is a guide to put these changes 

in context, and to show what they can 

do. Enter Zakas, creator of ESLint, 

and avery experienced JS developer. 
Starting with Block Bindings, 

one of ECMAScript 6’s solutions 

to previous versions’ problematic 

variable declarations, the author 

demonstrates admirable clarity 

in his explanations of how and 

why things work, followed by best 
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they are doing. The ‘where’ takes 
us on a tour of makerspaces, 
fab labs, and less formal 
wwe workshops. The ‘how’ 
explains the boards, tools, 
technologies, and whole 
maker ecosystem. The 
chapter on ‘The Maker 
Mindset’ is an essential 
examination of what 
drives us to create - from 
playfulness, to a need to 
understand more fully. 

The closing chapters on makers’ 
impact on the world, and a look at 
future development, provide food 
for thought. The notes, chronology, 
and bibliography are also of benefit. 
This fascinating book should, as 
Tim O’ Reilly puts it in the foreword, 
help you to “find your own inner 
maker. And start to measure 
yourself by what you make, 
not what you own or buy.” 


BB 


Score 


practice examples. So in the chapter 
on Iterators and Generators, Zakas 
gives you the historic background, 
then changes from 5 to 
6, how to implement, 
and only then — 
understanding accomplished 
— 6’s built-in Iterators. 
Classes are a big feature 
in 6, and get appropriate 
treatment — including their 
first class citizenship (you 
can pass them into functions 
as arguments). ECMAScript 6’s 
tail call optimisation, changes to 
defining Object String Tags, user- 
definable non-enumerable and 
non-writable object properties: it’s 
all here. Rounds off with a guide 
to ECMAScript 7 — or ECMAScript 
2016 — first of the new, yearly 
release cycle, containing only 
minor changes. Very readable. 
Recommended to any JavaScript 
user looking to grok ESO. 


Score 
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THE HITCHHIKER'S 
GUIDE TO PYTHON 


Authors: Kenneth Reitz 

& Tanya Schlusser 
Publisher: O'Reilly 
Price: £17.99 
ISBN: 978-1491933176 
magpi.cc/2gFXdsS 


“Python is big. Really 
big” — yes, there are 
plenty of Hitchhiker’s Guide to the 
Galaxy references here, a change 
at least from the obligatory Monty 
Python quotes in other Python 
works. Whimsy aside, this is a 
useful guide to immersing yourself 
in all things Pythonic, taking the 
confident beginner or intermediate 
programmer on a journey 
through the Python programmer’s 
ecosystem, everything from good 
code writing, to reading and learning 
form other programmers. 

The long chapter on “reading 
ereat code” is particularly useful 
for those looking to step up from 
beginner status, but we start 


C++ IN 24 HOURS 


SAMS TEACH YOURSELF 
Authors: Rogers Cadenhead 
& Jesse Liberty 
Publisher: SAMS iene 
Yoursett 
Price: £21.99 


C+ 


S20 tornoy 


ISBN: 978-0672337468 
magpi.cc/2gFZFzZH 


C++ is full of danger for 
the unwary, as it doesn’t 
provide the protections of higher- 
level languages like Java and Python, 
allowing you to shoot yourself in 
the foot, or even remove your leg. 
Nevertheless, much development 
on the range of interesting and 
low-cost boards available to makers 
needs C or C++ (or a subset thereof), 
and newbies still find themselves 
wanting to learn C++ to tackle 
embedded projects. It also remains 
fairly essential in gaming engines 
and other tasks where performance 
is critical. 

SAMS’ popular ‘... in 24 hours’ 
series break down complex 
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Kenneth Anji a Tanya Schlunsoy 


|. 


with a look at the programmer’s 
environment, from Python version 
and implementation, through 
virtualenv and its alternatives, 
to the ever expanding choice 
of text editors and IDEs - 
where some may disagree with 
the authors’ preference for 
proprietary choices. 

The final section, covering 
libraries, features several 
chapters, with coverage 
of those for user interaction, 
code management, interfaces, 
data manipulation, and data 
persistence. Along the way this 
takes in everything from Jupyter 
Notebooks, through Continuous 
Integration, to the little known (but 
passionately advocated) Pyramid 
web framework. For anyone lacking 
a coding mentor, and/or a group 
of experienced Python using co- 
workers, this is a very special sort of 
‘missing manual’. Recommended. 


Score 


learning subjects into hour-long 
lessons to give time for digestion 
between sessions (you won’t 
profit from trying to 
me work through the book 
sia in one caffeine-fuelled 
24-hour session!). The 


me success of the format is 


dependent upon every 
lesson building steadily 
at a good pace, and in 
eood order. 

No intro book can teach you 
everything about the sprawling 
C++ language. The authors make 
some sensible choices, and this is 
a good step up the first few rungs 
of a precarious ladder. However, 
some updates for new language 
features such lambda expressions 
don’t feel well integrated into 
the text. On balance, a good 
introduction, but you’1l need more 
resources to get further. 


Score 


BOOKS 


ESSENTIAL READING: 
NEW YEAR RESOLUTIONS 


Take the challenge: it’s time once again to 
resolve to learn something new. 


Resolution: Functional programming 


Functional Programming in JavaScript 
Author: Luis Atencio 
Publisher: Manning 
Price: £36.62 

ISBN: 978-1617292828 
magpi.cc/2gFPDPb 


Learn the benefits of the functional 


programming paradigm using a practical language 
that you know and love, and an authoritative guide. 


Resolution: Code a native mobile app 


Seven Mobile Apps in Seven Weeks 


Author: Tony Hillerson a 
Publisher: Pragmatic 

Severn Mote Apps 
Price: £28.50 a 
ISBN: 978-1680501483 ——_ 
magpi.cc/2gFYyjz [ 
Get to grips with building mobile apps for +) i ) | 


all devices with Pragmatic’s excellent and 
practical ‘Seven Weeks...’ series. 


Resolution: Learn to play Go! 


Go / Wei Qi / Baduk 


Author: British Go Association 
Publisher: Many online resources 
Price: Free - download GNUGo 
ISBN: N/A 

magpi.cc/2gFZ290 


Learn the 5,500-year-old strategy game 
that's taxed the finest Al researchers’ 
minds. Play online or join a club. 


Resolution: Debug some software! 


Effective Debugging 
Author: Diomidis Spinellis 
Publisher: Addison Wesley 
Price: £24.99 

ISBN: 978-0134394794 
magpi.cc/2gFVUdF 


Bugs are everywhere; learn the advanced 
methods, strategies, techniques, tools, and 
tactics to squash even the most persistent. 


Resolution: Learn to think logically! 


Logic as a Tool 


Author: Valentin Goranko 
Publisher: Wiley 

Price: £45.00 

ISBN: N/A 
magpi.cc/2h8d8kB 


Classical logic is hard but rewarding - 
helping with clarity in programming, business 
decisions, and whatever life throws at you. 
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THE MONTHIN 


Everything else that happened this month in the world of Raspberry Pi 


y the time you read 

this, you’ ll probably 

be doing last-minute 
preparations for the big day. 
Don’t forget to brine that 
turkey! You may also already 
have a load of Christmas 
decorations up, but there have 
been a few extra ones we’ve 


seen over the past month that We think this is very cute - a circuit 


you might want to consider a board built to look like a 3D Christmas 

if you’re a truly massive Raspberry Pi's Alex Bate designed these 3D-printable decorations for tree, with LEDs and resistors you can add 
the Raspberry Pi and Code Club fan in all of us. They're quick to print to it. You then pop it on the GPIO pins and 

Raspberry Pi fan. and all you need to do is add some string to hang it up on the tree! program it to do whatever you want. 
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This glowing festive house kit is wonderful - use a bit of Bare : we <a This should look familiar - it's our cover from last issue! It 


Conductive's electric paint and your own creativity to make this was created by Lenard Gunda (twitter.com/Lenardg) by 


lovely decoration. It doesn't use a Pi, but it's great nonetheless! = following our tutorial. Did you also make our cover light up? 
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CROWDFUND THIS! 


The best crowdfunding hits this month for you to check out... 


ARDUINO/ 
RASPBERRY PI 
I/O CARD 


GRASPI 


A prototyping board that connects to any 


/Kek.st/2fWNAS2 microcontroller or microcomputer with an [?C 


interface — which the Raspberry Pi has! It’s a very 


Sonic Pi is great, but so are guitars. GRasPi is a very well-thought-out piece of kit which greatly extends 
interesting concept, taking a portable, battery- the I?C of the Raspberry Pi, with loads of connectors 
powered 15W guitar amplifier and making it work with and a 16-bit processor on board. It’s already been 

a Raspberry Pi. This way, you can add effects and tie funded at the time of writing, so if you want to jump 


them to a pedal. It all runs on open-source software as on board and give this board a go, now’s the time! 
well, which is pretty great. The campaign is asking for 
a decent amount of money, though (these things aren’t 


cheap to build!), so have a look to see if it’s for you. BE ST ‘e) T H E RE ST 


peer = THWOMP 


SRACK 


The pitch for this campaign is that conventional racks 
are large and inconvenient, so why not create a more 
DIY approach with something a little smaller that you 
can use at home if you want? Also, it’s built around the 
size of a Raspberry Pi. As the name suggests, you can 
easily store nine Raspberry Pis on the rack when built, 
and its simple design means you get pretty good access 
to all sides of the Raspberry Pi. 


CHICKEN 
eo. es 


Chicken) 
Bouillon 
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“Post-lIts 

| drew for our 
#LetsRobot 
subscribers. We 
put these in the 
physical sets made 
for the robots. | still 
have a lot more 

to draw...” 


Let's 

Robot aims to 
change the way 
we interact with 
television, putting 
the viewer in the 
driving seat 


The mother of adventure-ready robots, 
Pokemon catchers, and helmets 


et’s Robot streams twice 

a week, Tuesdays and 

Thursdays, and allows 
the general public to control 
a team of robots within an 
interactive set, often consisting 
of mazes, clues, challenges, and 
even the occasional foe. Users 
work together via the Twitch. tv 
platform, sending instructions 
to the robots in order to navigate 
their terrain and complete the set 
objectives. Aylobot, the first robot 
of the project, boasts a LEGO body, 
while Ninabot, the somewhat 2.0 
upgrade of the two, has a gripper, 
allowing more interaction from 
users. Both robots have their own 
cameras that stream to Twitch, so 
that those in control can see what 
they’re up to on a more personal 


level; several new editions have 
jGiIned the robert team since ten: 
each with their own unique skill. 

Let’s Robot is the brainchild 
of Jillian Ogle, who originally 
set out to make “the world’s 
first interactive live show using 
telepresence robots collaboratively 
controlled by the audience” 
However, Jill discovered quite 
quickly that the robots needed to 
complete the project simply didn’t 
exist to the standard required... 
and so Let’s Robot was born. 

After researching various 
components for the task, Jill 
decided upon the Raspberry Pi, 
and it’s this small SBC that now 
exists within the bodies of Aylobot, 
Ninabot, and the rest of the Let’s 
Robot family. 
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In her previous life, Jill worked 
in art and game design, including 
a role as art director for Playdom, 
a subsidiary of Disney Interactive; 
she moved on to found Aylo Games 
in 2013 and Let’s Robot in 2015. The 
hardware side of the builds has been 
somewhat of a recently discovered 
skill, with Jill admitting, “Anything 
I know about hardware I’ve picked 
up in the last two years while 
developing this project.” 

More recently, as Let’s Robot 
continues to grow, Jill can be found 


The interactive sets take up a 
large part of the space at The Batchery, 
a ‘Global Startup Incubator’ in Oakland, 
California. 


Robot, originally a robot arm that 
would simulate the throw of an 
on-screen Poké Ball. It later grew 
wheels and took to the outside 
world, hunting down its pocket 
monster prey. It’s also worth 
noting other builds, such as the 
WiFi Livestream Goggles that Jill 
can be seen sporting across several 
social media posts. The goggles, 
with a Pi camera fitted between 


After researching various 
components for the task, Jill 
decided upon the Raspberry P!1 


sharing the antics of the robots 
across social media, documenting 
their quests such as the hilarious 
attempt tO cieale Darluy Inviles 
and the more recent Hillarybot vs 
Trumpbot balloon-head battle, 
where robots with extendable pin- 
mounted arms fight to pop each 
other’s head. 

Alongside the robots, Jill has 
created several other projects 
that both add to the interactive 
experience of Let’s Robot and 
comment on other elements of 
social trends out in the world. Most 
notably, there is the Pokémon Go 
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the wearer’s eyes, allow viewers 
to witness Jill’s work from her 
perspective. It’s a great build, 
especially given how open the 
Let’s Robot team are about their 
continued work and progression. 
And finally, one project we 
are eager to see completed is 
the ‘in production’ Pi-powered 
transparent HUD. By incorporating 
refractive acrylic, Jill aims to 
create a see-through display that 
allows her to read user comments 
via the Twitch live-stream chat, 
without having to turn her eyes to 
a separate monitor. 
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EVENTS 


Community 


EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 


themed events are happening near you... 


RASPBERRY JAM 
SILICON VALLEY 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 


ben@raspberrypi.org 


ALG all Gla IeIb le WelNits 


MANCHESTER 

RASPBERRY JAM 

When: Saturday 14 January 

Where: The Shed, Manchester, UK 
magpi.cc/2fW9ag8s 

Learn how to get started with the 
Raspberry Pi before attending 
workshops to learn more. 


MALVERN RASPBERRY PI 

JAM 

When: Wednesday 18 January 

Where: Wyche Innovation Centre, 
Malvern, UK 

magpi.cc/2fWb40e 

Show off your Raspberry 

Pi projects or just come to 

learn more about the Pi. 
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RASPBERRY JAM 
HONDURAS 

When: Friday 20 January 

Where: San Pedro Sula, Honduras 
magpi.cc/2fWkLf5 

An event for students to share 
knowledge of programming and 
electronics, and learn new things. 


RASPBERRY JAM 

SILICON VALLEY 

When: Saturday 21 January 

Where: Computer History Museum, 
Mountain View, CA, USA 

magpi.cc/2fW5KKg 

Find out about the Raspberry Pi 

and see other microcomputers 

at the Silicon Valley Jam. 


q RASPBERRY JAM 
- HONDURAS 


REGULAR EVENTS 


P| CLUB 

When: Wednesday 4 January 

Where: Fab lab inventors, 
Munich, Germany 

magpi.cc/2fW312q 

The last of a series of regular 

Jans nei Ina Ineein Invelicl eviciny 

Wednesday and Friday. 


TORBAY TECH JAM 
When: Saturday 14 January 
Where: Paignton Library and 
Information Centre, 
Paignton, UK 
torbaytechjam.org.uk 
This fun, family-friendly event aims 
to inspire people of all ages to get into 
coding and take up STEM subjects. 
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6 TORBAY TECH JAM 


HULL RASPBERRY JAM 
When: Saturday 21 January 
Where: Malet Lambert School, 

Jt Nls WUC 
magpi.cc/2fW2Epy 
Get hands-on with digital making 
activities through workshops and 
a hackspace area. 


13TH EGHAM 

RASPBERRY JAM 

When: Sunday 22 December 

Where: Gartner UK HQ, 
Staines-upon-Thames, UK 

magpi.cc/2fW3CSJ 

Post-Christmas, people will have 

new Raspberry Pis and components 

for making exciting projects. 
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JAMS 
EVERYWHERE! 
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FILL IN THE GAPS! 


SOUTH WEST NEEDS RASPBERRY JAMS 


While there are plenty of 
Raspberry Jams in the South 
East and Midlands, it's a bit 
harder to track down Jams in the 
farthest reaches of the South 
West of England. The regular 
Torbay Tech Jam is excellent, but 
it would be great to have a few 
more Jams going on! Find out 
more info on setting up Jams 
from previous issues and by 
heading to raspberrypi.org/jam. 
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LETTERS 


Download all the code 

Is there any way you could provide a ZIP file of all the code in each 
issue on your website when it’s released? This would make it a lot 
easier to obtain the code when you want to use it or copy it. 
Leonard Sparrow 


Right now we like to make sure all the code listings for the tutorials 
in the magazine exist somewhere online, usually via GitHub, so in the 
short term and for previous issues it might be best to follow those 
links to get the code and such. 

However, that is a pretty good idea. We have been thinking 
about putting all the code up on GitHub for each issue, and 
providing it all as an extra ZIP file on our GitHub or directly from 
our website shouldn’t be too much of an issue. Take a look on the 
page for this issue on our website and we’ll trial putting all the 
code into a ZIP file for everyone. 


More to do with C 


With the release of the special issue Learn to Code with C, I was quite 
happy. I am learning how to program in C with the intention of 
using it with microcontrollers and eventually Java with Android. 

What I was hoping to see in your release was some information on 
RPi GPIO with C. I did a little searching and found that there could 
easily have been one whole special issue on this topic. Here’s hoping 
to see that in the near future. 

One thing that I noticed is that there are some differences 
with the way that the Raspberry Pi reacts to printf formatting for 
pointers. Using the same program as found in the Pointers chapter, 
on Ubuntu MATE, gcc provides a warning, requires long integer 
formatting to gives the correct values, and actually needs pointer 
formatting to provide no compiler warnings at all. I gather the 
Raspberry Pi is set up in a way that is unique in some aspects. 

I realise that the onus is on the programmer to find all this stuff 
out, but it might be worth a mention somewhere along the way. 
The other thing I was hoping to find out is that C is as easy to use as 
Python with the Raspberry Pi. I have seen the WiringPi site, as well 
as a tutorial on SparkFun. 
Bruce Fleming 


We’re glad you like the C Essentials book: it seems like it has interested 
a lot of people and got them coding. We’ re definitely not done with C 
either and getting it working with the Pi’s GPIO is definitely something 
we’ ll be considering in the future, so keep your eyes peeled. 

As for differences between systems, this is a tricky one as there’s 
not much you can do about it. There can even be subtle differences 
between IDEs. We’re sure all the code works as expected on Raspbian, 
though, as that’s the main OS for all our Raspberry Pi stuff. 

Finally, Python is generally considered rather more straightforward 
to learn than C, which is why a lot of Pi stuff uses it! 


If you ever want to find out more info on Jams, 
there are great links on the Events pages 
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FROM THE FORUM: so vectntcrnstey ie delay in getting around the 
. world can make some of the more extremely time- 


sensitive topics a bit harder to get right. In the UK the 

mag did come out only the weekend before Halloween. 
Luckily, as you may have noticed from last issue, the 

Christmas content came out in plenty of time for the 


holiday season. Usually we try to make sure content 
which is seasonally themed in this manner comes out 


The Raspberry Pi Forum is a hotbed of well in advance — for example, last year our Halloween 
conversations and problem-solving feature was in the October issue, which came out right 
for the community - join in via at the end of September. 

raspberrypi.org /forums Hopefully this explains why it happened and that it 


shouldn’t occur too often. At least you now have a whole 
got my MagPi issue 51 today here in California, year to plan out your next Halloween projects! 
USA and there's a lot of good content; I 
enjoyed the ‘build a robot’ article. I see it 
promises ‘Spooky Halloween Projects’ on the cover, 
which seems an odd choice given the delivery date 
(1 November). Only 364 more days to go! 
jbeale 


Pi CAN BE MESSY. 
BUT IT DOESN'T 
HAVE TO BE. 


With a wide range of cables and 
enclosures for your Raspberry Pi 
projects and the WD PiDrive, WDLabs 
helps keep your creations properly 
powered and organized. 


wdlabs.wd.com/products 


© wDLABs 


We’ve had a great year full of excellent Raspberry Pi kits 
and add-ons and other bits, a treasure trove for makers of 
all skill levels. We’ve put some of them into a mystery box 
that one lucky reader will be able to win. What’s inside the 
box? You’ll have to win it to find out... 


Tell us by 23 January Simply email competition @raspberrypi.org 
for your chance to win! with your name, address, and answer! 


Terms & Conditions 


Competition closes on 23 January 2017. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Love your Pi’? Love Music? 


Designed by audio experts, enjoyed by everyone 


Jaw dropping audio quality for your Raspberry Pi 


t))) Connect Headphones, Speakers, RCA, Toslink, S/PDIF or XLR - 
: We work with all the major music solutions to ensure compatibility i} o— |= 
VD: as 4 
sonic PI MAX2PLAY 
pa 
moOdeff (4) VOLUMIO ¢ Archphile 
moOdel @) COON «archphite TT. 


Twitter: @IQ_audio lQaudio Limited, 
Email: info@iqaudio.com Cricklade Wiltshire. 
www.igaudio.com Company No.: 9461908 


Think e Create e Learn e Educate 


PiSTORMS-V2Z 


Make Stunning Robots with 
LEGOs and Raspberry Pi ! 


Column | THE FINAL WORD 


MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
and a contributing editor at Make: magazine. 


9 MAKING 
~ RESOLUTIONS 


‘Matt Richardson discusses how to rededicate yourself 
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to digital making in 2017 


floss my teeth every day. It’s the only New 
Year’s resolution that I’ve ever managed 

to keep, and I’ve now kept that promise to 
myself for many years. Admittedly ve made plenty 
of other resolutions, but they haven’t managed 

to stick. Even so, with 2017 around the corner, 

I thought it would be fun to discuss some of the 
possible resolutions for all of us as digital makers. 

Of course, So many resolutions are a recommitment 
to healthier living, and there’s no shortage of ways 
that digital making with Raspberry Pi can help 
us become healthier. In The MagPi issue 41, we 
featured Dot Silverman’s Motivational Bathroom 
Scale project. It’s a Raspberry Pi with a speaker 
hooked up to a bathroom scale. If you’re not meeting 
your weight-loss goals, it’1] berate you with sassy 
comments to motivate you to get back to the gym. 
You can, naturally, reprogram it to use positive 
reinforcement instead if you prefer. 

You could also use a Raspberry Pi Zero with an 
accelerometer to create your own pedometer, or hack 
your stationary bike so that you can only turn on the 
TV every day after you’ve cycled for 25 minutes. There 
are tons of ways that Raspberry Pi might be able to 
help you to live a healthier lifestyle. 

Along the lines of self-improvement, many people’s 
resolutions relate to learning. As digital making and 
learning go hand-in-hand, there’s an opportunity 
here to rededicate ourselves to learning more with 
Raspberry Pi. Try out a new programming language 
or Python library. Experiment with an electronic 
component you’ve never used. Learn to solder if you 
don’t know how to already. Dedicating weekly time 
to gaining a deeper understanding of some aspect of 
technology is something I would like to do in 2017. 
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Even better than resolving to teach yourself 
something new, you can also make a commitment 
to teaching others. You could volunteer at your local 
Code Club, teach a workshop at a Raspberry Jam, 
or help your local school. You could even sit down 
with a friend or family member and show them 
a thing or two about Linux and programming. | 
would encourage you to use all the free educational 
resources on our site to help you do that. 


Be inspired 

Are there any projects on your shelf that remain 
unfinished? Perhaps it’s time to take stock of those 
and commit to finishing them this year before taking 
on any new projects. Or if you’re looking for new 
project ideas, I’ve found that getting into the habit of 
daily brainstorming helps a great deal. You can keep 
a notebook and write out a page of ideas every day. 

It doesn’t matter if they’re practical or absolutely 
crazy. Just put pen to paper and get yourself thinking 
about what you want to make. I’ve found that when 
you get into the habit of challenging yourself to 
think creatively on a regular basis, the ideas start to 
come much more easily. 

There are many possible ways in which digital 
making and New Year’s resolutions coalesce. Even if 
you’re like me and you’ve broken more resolutions 
than you’ve kept, don’t let that discourage you. It’s 
certainly better to take stock of things and at least try 
to rededicate yourself to improvement as opposed to 
ceiving up before you’ve even started. In other words, 

a broken New Year’s resolution is better than one not 
made at all. Even if you end up sticking to just one 
resolution out of 30, you’re probably better off. I think 
at least my dentist would agree. 
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SB COMPONENTS 


CREATE YOUR OWN 
REMOTE CONTROLLED CAR 
OR OBSTACLE-SENSING sciminiiads 


FEATURES INCLUDE: 


¢ Light-weight aluminium 


e Electric motors 


° Large wheels ON _ 


¢ Stackable chassis plates 


www.robots.sb-components.co.uk Call: 0203 514 0914 


At SB Components we strive to offer our customers the best prices 
for the best products. Our product team works tirelessly to source top 
quality atfordable components from around the world. 


Raspberry Pi is a trademark of the Raspberry Pi Foundation. Raspberry Pi not included. 
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serial Pi Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout PF! Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Ditferential P 


8 channel 18 bit analogue to digital 
converter. I*C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. I?C 
address selection allows you to stack 
up to 4 1O Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I?C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


| Wire PI Plus 


1-Wire® to I?C host interface with ESD 
protection diode and I*C address 
selection. 
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AISO 
available 
for the 
Pi Zero 
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Cana 


The Perfect Holiday Gift! 
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A Wiley Brand 
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Build your own credit card 
sized computer 


Get started with program ming 
Set up a Media Center 
Make simple electronic circuits 


Raspberry Pj board and case 
oe supply and HDMI cable 
re-Programmed Memory Card 
— - electronic Parts 
Derry Pi Kit For Oummies Booklet 


FOR = 


DUMMIES 


Available in Europe 
Available for worldwide shipping at: through RS Components 


$89” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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